Skip to main content
GET
Get agent usage

Authorizations

Authorization
string
header
required

Access token from POST /management/v1/auth/token (publishable-key exchange) or a login session. Publishable-key tokens are agent-scoped and serve the messaging surface; login tokens also serve management.

Path Parameters

agentId
string
required
Pattern: ^[0-9a-fA-F]{24}$

Query Parameters

created_from
string<date-time> | null

Start of the usage window (RFC 3339). Maps to created>=.

created_to
string<date-time> | null

End of the usage window (RFC 3339). Maps to created<=.

Response

Successful Response

Usage metrics for one agent or across a project over the requested window.

interaction_count
integer
default:0

Number of billed interactions (one per interaction).

input_tokens
integer
default:0

Total input tokens.

output_tokens
integer
default:0

Total output tokens.

cache_read_tokens
integer
default:0

Total cached (read) input tokens.

reasoning_tokens
integer
default:0

Total reasoning tokens.

total_tokens
integer
default:0

Sum of input + output + cache-read + reasoning tokens.