Usage

Usage endpoints report metrics — interaction counts and token volume — for one agent or aggregated across a project, over a time window you choose.

Get usage

cURL

curl "https://api-v3.aui.io/apollo-api/management/v1/agents/{agentId}/usage?created_from=2026-07-01T00:00:00Z&created_to=2026-07-13T00:00:00Z" \
  -H "x-organization-api-key: <org_api_key>"

GET `/management/v1/agents/{agentId}/usage`

GET `/management/v1/projects/{projectId}/usage`

Same parameters and response for both — the project variant aggregates across every agent in the project.

Query parameters

string

Start of the usage window (RFC 3339). Omit for no lower bound.

string

End of the usage window (RFC 3339). Omit for no upper bound.

Response

integer

Number of interactions in the window.

integer

Total input tokens.

integer

Total output tokens.

integer

Total cached (read) input tokens.

integer

Total reasoning tokens.

integer

Sum of input, output, cache-read, and reasoning tokens.

{
  "interaction_count": 1284,
  "input_tokens": 512400,
  "output_tokens": 98211,
  "cache_read_tokens": 240100,
  "reasoning_tokens": 15320,
  "total_tokens": 866031
}

Get started

Messaging

Management

Get usage

GET `/management/v1/agents/{agentId}/usage`

GET `/management/v1/projects/{projectId}/usage`

Query parameters

Response

​Get usage

​GET /management/v1/agents/{agentId}/usage

​GET /management/v1/projects/{projectId}/usage

​Query parameters

​Response

Get usage

GET `/management/v1/agents/{agentId}/usage`

GET `/management/v1/projects/{projectId}/usage`

Query parameters

Response