Billing

Usage Billing History

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

Use types to filter the entries to list.

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

typesstring nullable

Comma-separated type values to return: usage_settled, top_up, void, expiry, or chargeback. When omitted, all types are returned. Rejects when an unrecognized name is supplied.

Example:top_up

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"
}

Changes

Changed in 3 of the 10 revisions of this API.27

Aug 28, 2026bbc2262e73bb1See the full diff
- ○
  added the new optional query request parameter types
  new-optional-request-parameter
Aug 13, 202616439be1524825See the full diff
- ▲
  response property entries/items/charged_units list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property entries/items/credited_units list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ○
  the response property entries/items/charged_units became required for the status 200
  response-property-became-required
- ○
  the response property entries/items/credited_units became required for the status 200
  response-property-became-required
- ○
  added the required property currency to the response with the 200 status
  response-required-property-added
- ○
  added the required property entries/items/charged_amount to the response with the 200 status
  response-required-property-added
- ○
  added the required property entries/items/credited_amount to the response with the 200 status
  response-required-property-added
Aug 12, 2026ceb7e0de7eaa1See the full diff
- ○
  endpoint added
  endpoint-added

Full history