---
title: "List sub-account transactions"
method: GET
path: "/v1/sub-organizations/{id}/billing/transactions"
tags: ["Sub-accounts"]
---

# List sub-account transactions

`GET /v1/sub-organizations/{id}/billing/transactions`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v1/sub-organizations/{id}/billing/transactions`
- Auth: HTTP bearer

Returns a paginated list of billing transactions for the sub-account identified by `id`, within the requested date range.

## Path parameters

- `id` integer, required

## Query parameters

- `from_date` string, date, required
- `to_date` string, date, required
- `type` union
  - integer
  - integer[]
- `page` integer
- `per_page` integer

## Response `200`

Returns a paginated list of sub-account transactions.

- SubAccountsTransactionsListResponse
  - `transactions` object[]: Financial transactions for the subaccount.
    - `amount` number, float: Transaction amount.
    - `balance_after` number, float: Sub-account balance after the transaction.
    - `date` string, date-time: Transaction date and time in ISO 8601 format.
    - `details` string: Transaction details.
    - `status` string: Transaction status.
    - `type` integer: Transaction type.
  - `pagination` Pagination
    - `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 transaction list is temporarily unavailable.

## Changes

- **2026-09-08** `6a89c962481c`: 1 info
  - added the non-success response with the status `400`
- **2026-06-15** `76b9bb35619f`: 5 info
  - added the optional property `success` to the response with the `503` status
  - the response property `pagination/current_page` became required for the status `200`
  - the response property `pagination/per_page` became required for the status `200`
  - the response property `pagination/total` became required for the status `200`
  - …1 more
- **2026-05-25** `33be77905120`: 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-04-20** `2e48fd9894e1`: 3 info
  - api operation id `Getusertransactions` removed and replaced with `sub_accounts_transactions_list`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `per_page`
- **2026-02-12** `fabaadf195a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/sub-organizations/:id/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)