Skip to main content
GET
Get agent usage

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Path Parameters

orgID
string
required
Pattern: ^org_[a-z2-7]{26}$
projectID
string
required
Pattern: ^proj_[a-z2-7]{26}$
agentID
string
required
Pattern: ^agt_[a-z2-7]{26}$

Query Parameters

since
string<date-time>

Only tally model calls started at or after this instant. Omit to start from the earliest recorded call.

until
string<date-time>

Only tally model calls started before this instant. Must be later than since when both are given. Omit to include calls up to now.

include_subagents
boolean

Also include usage from this agent's subagents at every depth. Defaults to false.

Response

Usage totals for the agent.

totals
object
required
by_model
object[]
required

Per-model rows ordered by provider config name, configured model name, then provider model slug. Models with distinct provider slugs across revisions appear once per slug.