List Transactions

GET 
/transactions

List your balance-ledger entries, newest first. Uses opaque cursor pagination: pass the next_cursor from a response as the cursor of the next request, and repeat until has_more is false.

Optionally filter to a single ledger entry type with entry_type.

Request

Responses

200

A cursor-paginated ledger page, newest first.

400

invalid_cursor — the supplied cursor value could not be decoded.

401

The X-API-Key header is missing, invalid or revoked. detail is a plain string: API key required, Invalid API key or User not found.

403

The account is blocked (plain-string detail: Account is blocked), or ip_not_allowed — the request's source IP is outside this key's IP allowlist.

422

Validation Error

429

Rate limit exceeded — more than 1,000 requests per minute for your account (shared by all of its API keys and workspace sessions). detail is a plain string; wait the number of seconds in Retry-After, then retry.

Response Headers

Retry-After

Seconds until the rate-limit window resets.