Skip to main content
GET
Get Usage History

Authorizations

X-API-Key
string
header
required

Your organization's API key (account in the bottom-left of the dashboard → Brosbots API).

Headers

authorization
string | null
X-API-Key
string | null

Query Parameters

start_date
string | null

ISO format date string

end_date
string | null

ISO format date string

page
integer
default:1
Required range: x >= 1
limit
integer
default:50
Required range: 1 <= x <= 500
filters
string | null

JSON string of filters

agent_id

Only this agent's conversations: its public ID (agent_...) or number.

Pattern: ^agent_[A-Za-z0-9]{20}$

Response

Successful Response

runs
ConversationUsageResponse · object[]
required
total_credits
number
required
total_duration_seconds
integer
required
total_count
integer
required
page
integer
required
limit
integer
required
total_pages
integer
required