List what your calls cost

​

Returns one charge per call, newest first. A charge is created when the call is placed and is finalized once its true cost is known, so an amount can still change until finalized_at is set.

Query Parameters

  • call_id
    Type: stringnullable

    Only return the charge for this call.

  • finalized
    Type: booleannullable

    True returns only settled charges; false returns only charges whose amount can still change.

  • cursor
    Type: stringnullable

    The next_cursor from the previous page. Omit it for the first page.

  • limit
    Type: integer
    min:  
    1
    max:  
    200

    How many charges to return per page.

Responses

  • application/json
  • application/json
Request Example for get/v1/call-charges
curl '/v1/call-charges?limit=50' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "id": "01K1SA6D2E9NP3R7T5W8XQ4MHZ",
      "call_id": "01K1SA3F7M8QW2V5C9H4YTB0KD",
      "amount_in_cents": 25,
      "created_at": "2026-09-24T21:09:12.206Z",
      "finalized_at": "2026-09-24T21:09:12.206Z"
    }
  ],
  "next_cursor": "MDFLMVNBM0Y3TThRVzJWNUM5SDRZVEIwS0Q"
}

Successful Response