Two endpoints report forwarding usage. GET/v1/forwarding/stats returns totals for a period (rules, calls, answered, failed, minutes and cost), defaulting to the last 30 days. GET/v1/forwarding/analytics adds a day-by-day series and a per-number breakdown with answer rate, for the last 1 to 90 days. They power the portal's dashboard and Analytics page.

Usage totals#

GET/v1/forwarding/stats

Name	Type	Description
`start_date`	RFC 3339	Start of the period. Default 30 days ago
`end_date`	RFC 3339	End of the period. Default now

curl "https://voice-api.edesy.in/v1/forwarding/stats" \
  -H "Authorization: Bearer sk_your_api_key"

{
  "data": {
    "total_rules": 2,
    "active_rules": 1,
    "total_calls": 148,
    "answered_calls": 121,
    "failed_calls": 9,
    "total_minutes": 312.5,
    "total_cost": 338
  },
  "meta": { "timestamp": "2026-10-16T09:30:00Z" }
}

Field	Description
`total_rules`, `active_rules`	Forwarding rules in the workspace, and how many are active
`total_calls`	Calls in the period
`answered_calls`	Calls that were answered
`failed_calls`	Calls that failed
`total_minutes`	Minutes in the period
`total_cost`	Spend in INR

Analytics#

GET/v1/forwarding/analytics

Name	Type	Description
`days`	integer, 1 to 90	How many days back. Default 30

curl "https://voice-api.edesy.in/v1/forwarding/analytics?days=7" \
  -H "Authorization: Bearer sk_your_api_key"

{
  "data": {
    "range_start": "2026-10-09T09:30:00Z",
    "range_end": "2026-10-16T09:30:00Z",
    "totals": { "total_rules": 2, "active_rules": 1, "total_calls": 31, "answered_calls": 27, "failed_calls": 1, "total_minutes": 64, "total_cost": 70 },
    "timeseries": [
      { "date": "2026-10-15", "calls": 6, "answered": 5, "minutes": 11.5, "cost": 13 }
    ],
    "by_number": [
      { "did_number": "8071387146", "calls": 31, "answered": 27, "minutes": 64, "cost": 70, "answer_rate": 0.87 }
    ]
  },
  "meta": { "timestamp": "2026-10-16T09:30:00Z" }
}

Field	Description
`range_start`, `range_end`	The period covered
`totals`	Same fields as usage totals
`timeseries[]`	One entry per day (`YYYY-MM-DD`): calls, answered, minutes, cost. Days with no calls are included as zeros
`by_number[]`	Per virtual number: calls, answered, minutes, cost and `answer_rate` (0 to 1)

The example figures are illustrative.