Skip to main content
GET
Python (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Query Parameters

from
string<date-time>

Inclusive RFC 3339 timestamp on an exact UTC minute boundary; never rounded.

to
string<date-time>

Exclusive RFC 3339 timestamp on an exact UTC minute boundary; never rounded and cannot be later than the server's current UTC minute boundary.

resource_type
enum<string>
Available options:
job,
service,
volume
cursor
string
limit
integer
default:50
Required range: 1 <= x <= 200

Response

Usage in the half-open requested window

data
object[]
required
granularity
enum<string>
required

Required alignment and allocation granularity of the requested window.

Available options:
minute
next_cursor
string | null
required
summary
object
required
total
integer
required
volume_allocation
enum<string>
required

Finalized hourly volume totals are allocated uniformly over their immutable billable interval.

Available options:
uniform_proration
volume_ledger_granularity
enum<string>
required

Immutable UTC bucket granularity of standalone-volume billing rows.

Available options:
hour
volume_usage_complete
boolean
required

True only when every relevant standalone volume has a contiguous durable ledger prefix through window.to.

volume_usage_complete_through
string<date-time>
required

Conservative organization-wide standalone-volume ledger watermark, capped to the requested window.

window
object
required