v50

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-06-16122182589.7 KB

Billing

List transactions

Returns a paginated list of billing transactions for the authenticated account within the requested date range.

get/v1/billing/transactions

Query parameters

from_datestring date required

Example:2023-08-01

Start of the date range to query, in YYYY-MM-DD format. Inclusive.

to_datestring date required

Example:2023-08-31

End of the date range to query, in YYYY-MM-DD format. Inclusive.

type0 | 2 | 3 | 6 | 11 | 14 | 15 | 19 | 20 | 23 | 24 | 25 | 26 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60

Transaction type:

0 - Payment adjustment
2 - Phone number activation fee
3 - Phone number monthly fees
6 - Phone number forwarding
11 - PSTN forwarding fee
14 - Outbound call
15 - Outbound SMS
19 - Credit card payment
20 - Payment fee
23 - Porting fee
24 - Inbound SMS
25 - Admin payment
26 - Subscription payment
29 - Number validator
30 - Call recording
31 - Storage charge
32 - Campaign builder
33 - Voicemail detection
34 - Sender ID registration
35 - Sender ID monthly fee
36 - 2FA
37 - IVR
38 - E911 activation
39 - Outbound MMS
40 - Inbound MMS
41 - Call transcription
42 - 10DLC Brand registration
43 - 10DLC Campaign registration
44 - Phone number order
45 - Adjustment in
46 - URL shortener
47 - 10DLC Brand update
48 - 10DLC Brand appeal
49 - Audio transcription
50 - 10DLC Brand vetting
51 - 10DLC Brand vetting appeal
52 - Outbound SMS carrier fee
53 - Inbound SMS carrier fee
54 - Outbound MMS carrier fee
55 - Inbound MMS carrier fee
57 - Outbound SMS segment
58 - Inbound SMS segment
59 - Outbound MMS segment
60 - Inbound MMS segment

Filters transactions by type. Accepts a TransactionType value.

details_containsstring

Example:monthly

Filters transactions whose details contain the given substring.

paymentsboolean

Example:true

When true, returns only account top-up transactions. Defaults to all transaction types.

pageinteger

Example:1

Page number to retrieve. Default 1.

per_pageinteger

Example:25

Number of records to return per page. Default 25.

Response

Returns a paginated list of billing transactions.

is_emptyboolean required

Indicates whether there are no transactions.

Example response

{
  "is_empty": false,
  "transactions": [
    {
      "id": 24789389,
      "amount": -0.99,
      "balance_after": 309.0601,
      "date": "2023-08-29T14:48:38.000Z",
      "details": "Monthly fee for 16419252149",
      "status": "Committed",
      "type": 3,
      "show_invoice": false
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total": 1,
    "total_pages": 1
  }
}