Sign in
billing-usage

Get workspace credit history

Plan: Enterprise

Returns the workspace's credit grant, expiry, adjustment, and conversion history, ordered by occurred_at descending with entry ID as the cursor tie-breaker.

get/v1/workspaces/{workspace_id}/billing/credit-history

Path parameters

workspace_idstring required

Workspace ID

Workspace ID

Query parameters

event_typestring[] nullable

Filter to one or more event types. Repeat to include multiple; omit for all.

Filter to one or more event types. Repeat to include multiple; omit for all.

limitinteger

Maximum number of items to return

Maximum number of items to return

cursorstring

Opaque pagination cursor returned by the previous page

Opaque pagination cursor returned by the previous page

Response

OK

totalinteger

Total entry count, present only on the first page. Capped — see total_is_capped.

total_is_cappedboolean

True when total reached the count cap and the real total is higher.

Example response

{
  "data": [
    {
      "credits_change": 1500,
      "event_type": "granted",
      "grant_type": "billing",
      "id": "01jw3k9m2xq8r5v0c7d4e6f2gh",
      "label": "Monthly plan credit grant",
      "occurred_at": "2026-01-15T09:30:00Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJ2IjoxLCJpZCI6InByal8wMWp3M2s5In0"
  },
  "total": 42
}

Changes

No recorded changes to this endpoint across all 12 revisions of this API.