v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014102371.0 MB

Billing

Get list of billings

Retrieve a list of the customer's billings.

get/billings

Query parameters

page_sizeinteger

Example:25

Number of results to return per page.

page_tokenstring

Cursor token for pagination. Use the next_page_token value from the previous response.

Response

A list of billings.

next_page_tokenstring

Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.

Example response

{
  "result": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
      "account_id": "b8c9d0e1-f2a3-4567-8901-23456789abcd",
      "transaction_type": "usage",
      "status": "progressing",
      "reference_type": "call",
      "reference_id": "f6a7b8c9-d0e1-2345-6789-0abcdef01234",
      "cost_type": "call_pstn_outgoing",
      "usage_duration": 125,
      "billable_units": 3,
      "rate_token_per_unit": 10,
      "rate_credit_per_unit": 50000,
      "amount_token": -30,
      "amount_credit": -150000,
      "balance_token_snapshot": 470,
      "balance_credit_snapshot": 1350000,
      "idempotency_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "tm_billing_start": "2026-01-15T09:30:00.000000Z",
      "tm_billing_end": "2026-01-15T09:30:00.000000Z",
      "tm_create": "2026-01-15T09:30:00.000000Z",
      "tm_update": "2026-01-15T09:30:00.000000Z",
      "tm_delete": "2026-01-15T09:30:00.000000Z"
    }
  ]
}