Skip to main content
GET
Get organization usage history

Authorizations

Authorization
string
header
required

JWT access token for user authentication (Authorization: Bearer <jwt_token>). Create via POST /users/me/access_tokens.

Path Parameters

org_id
string
required

Organization ID

Query Parameters

limit
integer<int64>

Number of records to return (default: 100)

offset
integer<int64>

Offset for pagination (default: 0)

start_date
string

Inclusive UTC start date in YYYY-MM-DD or RFC3339 format.

end_date
string

Inclusive UTC end date in YYYY-MM-DD or RFC3339 format.

start_time
string

Inclusive RFC3339 start timestamp. Takes precedence over start_date.

end_time
string

Inclusive RFC3339 end timestamp. Takes precedence over end_date.

workspace_id
string<uuid>

Filter by workspace ID.

api_key_id
string<uuid>

Filter by API key ID.

credit_type
enum<string>

Filter costs by their saved credit allocation. Credit type for organization limits

  • grant: Free credits provided by the platform
  • payment: Credits purchased by the organization
  • staking_farm: House of Stake farm reward units converted into credits
  • postpay: Contract billing safety ceiling; usage is invoiced separately
Available options:
grant,
payment,
staking_farm,
transfer,
postpay

Response

Usage history

Usage history response

data
object[]
required
limit
integer<int64>
required
offset
integer<int64>
required
total
integer
required

Number of matching records. Without filters this is the organization's recorded request count (total_requests in the balance), which can exceed the rows still stored, so a final page may come back short or empty.

Required range: x >= 0