API Reference
Log In
API Reference

Get call count by agent over time

Returns the number of calls per agent for each time bucket in the window, for charting request volume. Calls with no agent are not counted. Agents named in agents appear in every bucket, with 0 where they had no calls. For one count per agent over the whole window, use GET /v2/api/sources/metrics/ai/call-count-metrics-by-agents.

Bucket size by period: HOUR 5 minutes, EIGHT_HOURS 30 minutes, TWENTY_FOUR_HOURS 2 hours, SEVEN_DAYS 12 hours, THIRTY_DAYS 1 day, NINETY_DAYS 1 week, SIX_MONTHS and TWELVE_MONTHS 1 calendar month. Buckets are cut in UTC. Monthly buckets start at midnight UTC on the first of each month; shorter buckets start at the beginning of the window, which is the time of the request minus the period. With a custom startDate and endDate the range is not split evenly: the response has ten buckets, the first covers the whole range and the other nine are empty. Buckets are listed oldest first.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

ID of the team that owns this data.

string
enum

Predefined time window to aggregate results (e.g., TWELVE_MONTHS). Ignored if both startDate and endDate are provided. Defaults to TWELVE_MONTHS when no custom date range is specified.

string

Start of a custom date range in ISO 8601 format (e.g., 2025-09-01T00:00:00Z). Must be provided together with endDate. When both are provided, the period parameter is ignored and this custom range is used instead.

string

End of a custom date range in ISO 8601 format (e.g., 2025-09-30T23:59:59Z). Must be provided together with startDate. When both are provided, the period parameter is ignored and this custom range is used instead.

agents
array of strings

Optional list of agent identifiers to include (e.g., 'claude-code'). Omit to include all agents.

agents
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*