---
title: "List transactions"
method: GET
path: "/v1/billing/transactions"
tags: ["Billing"]
---

# List transactions

`GET /v1/billing/transactions`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v1/billing/transactions`
- Auth: HTTP bearer

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

## Query parameters

- `from_date` string, date, required
- `to_date` string, date, required
- `type` 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: 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
- `details_contains` string
- `payments` boolean
- `page` integer
- `per_page` integer

## Response `200`

Returns a paginated list of billing transactions.

- BillingTransactionListResponse
  - `is_empty` boolean, required: Indicates whether there are no transactions.
  - `transactions` FinancialTransaction[], required: List of transactions.
    - `id` integer, required: Transaction ID.
    - `date` string, date-time, required: Creation date and time in ISO 8601 format.
    - `amount` number, float, required: Transaction amount. Negative values decrease balance.
    - `balance_after` number, float, required: Account balance after the transaction.
    - `details` string, required: Transaction details.
    - `status` 'Created' | 'Pending' | 'Committed' | 'Reverted', required: Current status of the transaction. One of `Created` (the transaction was created but not yet processed), `Pending` (the transaction is being processed), `Committed` (the transaction was applied to the balance), or `Reverted` (the transaction was rolled back).
    - `type` 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, required: 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
    - `show_invoice` boolean, required: Indicates whether a transaction receipt is available. Receipts are available only for transaction types 0, 8, 9, 19, 23, and 25.
  - `pagination` Pagination, required
    - `current_page` integer, required: Current page number.
    - `per_page` integer, required: Number of records per page.
    - `total` integer, required: Total number of records.
    - `total_pages` integer, required: Total number of pages.

## Other responses

- `400`: Request failed. Missing or invalid parameter <param_name>
- `401`: Unauthorized
- `403`: Request failed. The feature is disabled for your account.
- `404`: Request failed. An object with the specified ID is not found.
- `503`: Returns when the billing service is temporarily unavailable.

## Changes

- **2026-09-14** `d4db3aae3627`: 2 breaking, 45 info
  - the `query` request parameter `type` was restricted to a list of enum values
  - for the `query` request parameter `type`, the type changed from no type to `integer`
  - added the new enum value `0.00` to the `query` request parameter `type`
  - added the new enum value `11.00` to the `query` request parameter `type`
  - …43 more
- **2026-09-08** `6a89c962481c`: 1 breaking, 6 info
  - the response's body type changed from no type to `object` for status `200`
  - removed `#/components/schemas/BillingTransactionListResponse, subschema #2` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - …3 more
- **2026-06-15** `76b9bb35619f`: 2 breaking
  - for the `query` request parameter `from_date`, the format changed from no format to `date`
  - for the `query` request parameter `to_date`, the format changed from no format to `date`
- **2026-05-25** `33be77905120`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- …earlier changes not shown

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/billing/transactions/get.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) - [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/f2dde79f05ab?raw)
