Get Daily Calls

Retrieve time-series call metrics over a specified period.

GET /api/analytics/calls/daily

Get Daily Calls

cURL

curl --request GET \
  --url https://api.example.com/api/analytics/calls/daily

200

{
  "success": true,
  "data": {
    "period": {},
    "granularity": "<string>",
    "daily": [
      {
        "date": "<string>",
        "calls": 123,
        "cost_credits": 123,
        "total_duration_seconds": 123
      }
    ]
  }
}

Provides an array of metrics grouped by time interval (either days or minutes depending on your parameters). This is ideal for generating line charts of call volume and duration.

Query Parameters

start_date · string

Start date in YYYY-MM-DD format. Defaults to 30 days ago.

end_date · string

End date in YYYY-MM-DD format. Defaults to today.

start_datetime · string

Start exact time in ISO 8601 format (e.g. 2024-03-01T14:30:00Z). Changes the granularity of the time-series points to minute.

end_datetime · string

End exact time in ISO 8601 format.

agent_id · string

Filter the metrics to only include calls for a specific agent.

Response

success · boolean

Indicates whether the request was successful.

data · object

Show properties

period · object

The start and end boundaries of the query.

granularity · string

The time grouping used for the data points. Either day or minute.

daily · array

Array of data points matching the granularity.

Show items

date · string

The date (or exact timestamp if minute granularity) for this data point.

calls · integer

Total number of calls during this interval.

cost_credits · number

Platform credits consumed by these calls.

total_duration_seconds · number

Sum of call durations in seconds for this interval.