List what your phone numbers cost

​

Returns one charge per phone-number billing event, newest first: the number's one-time purchase charge, minted when its order completes, and one rental charge per calendar month of ownership, minted on the first day of each month starting with the first full month after purchase. Amounts are a fixed multiple of the cost the carrier quoted for the number, rounded up to the whole cent.

Query Parameters

  • phone_number
    Type: stringnullable

    Only return charges for this owned phone number, in E.164 format.

  • 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/phone-number-charges
curl '/v1/phone-number-charges?limit=50' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "id": "01K1SA6D2E9NP3R7T5W8XQ4MHZ",
      "phone_number": "+14155550199",
      "charge_kind": "purchase",
      "rental_month": "2026-09-01",
      "amount_in_cents": 300,
      "created_at": "2026-09-24T21:09:12.172Z",
      "finalized_at": "2026-09-24T21:09:12.172Z"
    }
  ],
  "next_cursor": "MDFLMVNBM0Y3TThRVzJWNUM5SDRZVEIwS0Q"
}

Successful Response