List what your text messages cost

​

Returns one charge per recipient message, newest first. A charge is created when the message is accepted and is finalized at a fixed multiple of the cost the carrier reports for it, rounded up to the whole cent — or at a small fixed price when the carrier never reports a cost for an accepted message — so an amount can still change until finalized_at is set. A recipient refused before sending finalizes at zero.

Query Parameters

  • text_message_id
    Type: stringnullable

    Only return the charge for this text message.

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

{
  "items": [
    {
      "id": "01K1SA6D2E9NP3R7T5W8XQ4MHZ",
      "text_message_id": "01K1SA3F7M8QW2V5C9H4YTB0KD",
      "amount_in_cents": 2,
      "created_at": "2026-09-24T21:09:12.163Z",
      "finalized_at": "2026-09-24T21:09:12.163Z"
    }
  ],
  "next_cursor": "MDFLMVNBM0Y3TThRVzJWNUM5SDRZVEIwS0Q"
}

Successful Response