Skip to content
roasOS API
Esc
↑↓navigate↵open⌘Jpreview

List billing history

GET/v1/account/ledger
Query parameters
cursorstring
Opaque composite pagination cursor from the previous response. Do not parse or construct it.
limitinteger
Number of items to return
min 1 · max 100 · default: 20
Responses
200Confirmed immutable workspace credit events
dataobject[]required
max items 100
Show properties
Array of object
idstring<uuid>required
paid_request_idstring<uuid>required
generation_idstring<uuid> | nullrequired
event_kindstringrequired
Allowed:reservationsettlement_chargesettlement_refundfailure_refund
creditsintegerrequired
min 0
directionstringrequired
Allowed:debitcredit
operationstringrequired
min length 1 · max length 96
modelstring | nullrequired
min length 1 · max length 160
pricing_versionstring | nullrequired
min length 1 · max length 80
api_key_idstring<uuid> | nullrequired
surfacestring | nullrequired
Allowed:public_api
projectstring | nullrequired
min length 1 · max length 64
cost_centerstring | nullrequired
min length 1 · max length 64
quote_request_idstring<uuid> | nullrequired
confirmation_request_idstring<uuid> | nullrequired
created_atstring<date-time>required
metaobjectrequired
Show properties
cursorstring
min length 1 · max length 4096
has_morebooleanrequired
Request
curl -X GET "https://api.roasos.com/v1/account/ledger"
Response
{
  "data": [
    {
      "id": "<uuid>",
      "paid_request_id": "<uuid>",
      "generation_id": "<uuid>",
      "event_kind": "reservation",
      "credits": 0,
      "direction": "debit",
      "operation": "string",
      "model": "string",
      "pricing_version": "string",
      "api_key_id": "<uuid>",
      "surface": "public_api",
      "project": "string",
      "cost_center": "string",
      "quote_request_id": "<uuid>",
      "confirmation_request_id": "<uuid>",
      "created_at": "2024-01-01T00:00:00Z"
    }
  ],
  "meta": {
    "cursor": "string",
    "has_more": true
  }
}