GET
/
v1
/
billing
/
transactions
List transactions
curl --request GET \
  --url https://api.wavix.com/v1/billing/transactions \
  --header 'Authorization: Bearer <token>'
{
  "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
  }
}

Authorizations

​
Authorization
string
header
required

Wavix API key. Pass as Authorization: Bearer <api_key>. Keys support per-resource scopes (none / read / write). See Restricted keys and scopes.

Query Parameters

​
from_date
string<date>
required

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

Example:

"2023-08-01"

​
to_date
string<date>
required

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

Example:

"2023-08-31"

​
type
enum<integer>

Filters transactions by type. Accepts a TransactionType value. 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
  • 56 - 10DLC Campaign vetting fee
  • 57 - Outbound SMS segment
  • 58 - Inbound SMS segment
  • 59 - Outbound MMS segment
  • 60 - Inbound MMS segment
Available options:
0,
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
​
details_contains
string

Filters transactions whose details contain the given substring.

Example:

"monthly"

​
payments
boolean

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

Example:

true

​
page
integer<int32>

Page number to retrieve. Default 1.

Example:

1

​
per_page
integer<int32>

Number of records to return per page. Default 25.

Example:

25

Response

Returns a paginated list of billing transactions.

​
is_empty
boolean
required

Indicates whether there are no transactions.

Example:

false

​
transactions
FinancialTransaction · object[]
required

List of transactions.

Example:
[
  {
    "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
Pagination · object
required