Skip to main content
GET
Return API usage history

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer

Maximum number of results to return. The Gateway may return fewer results.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor returned by the preceding response. Omit it on the first request. Do not construct, modify, or reuse it outside this pagination flow.

Maximum string length: 1000
status
enum<string>

Optional usage status filter.

Available options:
success,
failed
api_id
string

Optional AgentBody capability identifier returned by usage history. Use it only to filter this API key's usage records.

Response

Recent API usage records.

has_more
boolean
required
items
object[]
required
next_cursor
string | null
required