Skip to content

usage.listUsageEvents

GET
/v1/organization/usage/events
curl --request GET \
--url https://example.com/v1/organization/usage/events \
--header 'Authorization: Bearer <token>'

Lists model calls, the newest first. Send next as after to get the next page.

from
string
to
string
after
string
limit
string

Success

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
>= 1 characters <= 128 characters
executionId
required
Any of:
string
>= 1 characters <= 128 characters
status
required
string
Allowed values: pending confirmed unknown
startedAt
required
string
reservedMicros
required
integer
<= 9007199254740991
estimatedMicros
required
Any of:
integer
<= 9007199254740991
estimatedTokens
required
integer
<= 9007199254740991
occurredAt
required
string
source
required
string
Allowed values: turn compaction judge bot_memory other
chatId
required
Any of:
string
turnId
required
Any of:
string
botId
required
Any of:
string
userId
required
Any of:
string
tokenId
required
Any of:
string
>= 1 characters <= 128 characters
provider
required
string
providerOwner
required
string
Allowed values: platform organization
model
required
string
inputUncached
required
Any of:
integer
>= -9007199254740991 <= 9007199254740991
inputCacheRead
required
Any of:
integer
>= -9007199254740991 <= 9007199254740991
inputCacheWrite
required
Any of:
integer
>= -9007199254740991 <= 9007199254740991
outputText
required
Any of:
integer
>= -9007199254740991 <= 9007199254740991
outputReasoning
required
Any of:
integer
>= -9007199254740991 <= 9007199254740991
priced
required
boolean
costMicros
required
Any of:
integer
<= 9007199254740991
charged
required
boolean
next
required
Any of:
string

Example

{
"items": [
{
"status": "pending",
"source": "turn",
"providerOwner": "platform"
}
]
}

UsageQueryInvalid | OrganizationRequired

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: UsageQueryInvalid
message
required
string

Example

{
"_tag": "UsageQueryInvalid"
}

AuthenticationRequired

Media typeapplication/json
object
_tag
required
string
Allowed values: AuthenticationRequired

Example

{
"_tag": "AuthenticationRequired"
}

@nmnmcc/ability/Authorizer/Forbidden | MembershipRequired | ForbiddenOrigin

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: Forbidden
action
required
string
kind
required
string
field
string
reason
string

Example

{
"_tag": "Forbidden"
}

@nmnmcc/ability/Authorizer/Pending

Media typeapplication/json
object
_tag
required
string
Allowed values: Pending
ticket
required
string
reason
string

Example

{
"_tag": "Pending"
}

RateLimited

Media typeapplication/json
object
_tag
required
string
Allowed values: RateLimited
retryAfterSeconds
required
integer
>= -9007199254740991 <= 9007199254740991

Example

{
"_tag": "RateLimited"
}

BillingUnavailable | AuthenticationUnavailable | RequestFailed

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: PolicyUnavailable

Example

{
"_tag": "PolicyUnavailable"
}