Skip to main content
GET
cURL
Read immutable workspace funding, usage, adjustment and final-refund entries. Use typed billing exports for detailed statements, workload and historical rates. All IDs and cursors must belong to the authorized workspace and environment. Required scope: billing:read. Owner authority is required. Related reads can pin snapshot_id from billing summary to reconcile the same as-of state; expired snapshots return 410, never a silent refresh. Examples use synthetic IDs. Replace them with values returned by your environment.

Authorizations

Authorization
string
header
required

Server-to-server API key bound to exactly one workspace, institution tenant and environment. No caller-supplied workspace override is accepted. Do not use in public browser code.

Query Parameters

cursor
string

cursor

Minimum string length: 1
limit
integer
default:25

limit

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

snapshot id

Minimum string length: 1
kind
enum<string>

kind

Available options:
funding,
usage,
adjustment,
final_refund
product
enum<string>

product

Available options:
insights,
signal
payment_id
string

payment id

Minimum string length: 1
usage_id
string

usage id

Minimum string length: 1
posted_from
string<date-time>

posted from. UTC ranges are inclusive from and exclusive to; reject to <= from.

posted_to
string<date-time>

posted to. UTC ranges are inclusive from and exclusive to; reject to <= from.

Response

Successful response.

data
object[]
required
meta
object
required
page
object
required

Opaque cursor binds filters, authorization and a stable snapshot. Expired cursors return 410; never silently restart.