Skip to navigation

Get usage

Returns the tokens billed in the current period.

Authentication

AuthorizationBearer

An API key: Authorization: Bearer bl_live_….

OR
AuthorizationBearer

Blende’s apps: a sign-in JWT, sent with Blende-Context-Key.

Response headers

Cache-ControlenumOptional

Always no-store.

Allowed values:
Request-IdstringOptional
The request's id.
RateLimitstringOptional
The quota left in the current window.
RateLimit-PolicystringOptional

The rate-limit policy in force.

Response

The current period's usage.
period_start_timedatetime

RFC 3339: when the period started.

period_end_timedatetime

RFC 3339: when the period ends.

tokens_usedinteger>=0
The tokens billed in the period.

Errors

401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error