Sign in
latestOpenAPI 3.1.02026-08-211061591.1 MB

69a962f1578f

Billing

Usage Billing History

List the caller's usage-billing ledger entries, newest first.

This is a paginated endpoint. See the Pagination guide for details on using cursor-based pagination.

get/api/v1/usage_billing/history

Query parameters

productstring

Product whose ledger to read.

Example:automations
cursorstring nullable

An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request

Example:14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55
limitinteger

The number of objects to return in a page

Example:50

Response

Successful Response

currencystring required

ISO currency code every amount in this page is in. On the page rather than on each entry: the account pins one price for its whole life (spec section 8), so no two entries can differ.

has_moreboolean required

Whether another page of results is available.

next_cursorstring

Cursor for the next page of results.

Example response

{
  "currency": "usd",
  "entries": [
    {
      "id": 8814,
      "type": "usage_settled",
      "created_at": "2026-06-10T14:00:00Z",
      "category": "automation_run",
      "status": "success",
      "charged_units": 13700,
      "charged_amount": 27400,
      "credited_units": 5000000,
      "credited_amount": 10000000,
      "description": "Top-up USD 1000"
    }
  ],
  "next_cursor": "14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55"
}