---
title: "List customer transactions"
method: GET
path: "/api/v1/partner/accounts/{customer_auth_id}/transactions"
tags: ["Partner API"]
---

# List customer transactions

`GET /api/v1/partner/accounts/{customer_auth_id}/transactions`

## Request

- Base URL: `https://api.vobiz.ai`
- URL: `https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/transactions`
- Auth: API key in header `X-Auth-ID` and API key in header `X-Auth-Token`
- TypeScript: <https://skmtc.dev/vobiz/apis/vobiz-api/docs/api/v1/partner/accounts/:customer_auth_id/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the customer's transaction ledger. Filter by date range or
transaction type. Useful for billing reconciliation.

## Path parameters

- `customer_auth_id` string, required

## Query parameters

- `from_date` string, date
- `to_date` string, date
- `transaction_type` 'recharge' | 'debit' | 'refund' | 'transfer'
- `page` integer
- `per_page` integer

## Response `200`

Transactions list

- object
  - `transactions` object[], required
    - `id` string, required
    - `account_id` string, required
    - `balance_id` string, required
    - `type` string, required
    - `amount` integer, required
    - `currency` string, required
    - `description` string, required
    - `reference` string, required
    - `status` string, required
    - `processed_at` string, required
    - `created_at` string, required
    - `updated_at` string, required
  - `summary` object, required
    - `total_transactions` integer, required
    - `total_debit` integer, required
    - `total_credit` integer, required
    - `net_amount` integer, required
    - `by_reference_type` object[], required
      - `reference_type` string, required
      - `total_debit` integer, required
      - `total_credit` integer, required
      - `count` integer, required
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `total_pages` integer, required
  - `account_auth_id` string, required

---

[API](https://skmtc.dev/vobiz/apis/vobiz-api.md) - [All operations](https://skmtc.dev/vobiz/apis/vobiz-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vobiz/apis/vobiz-api/revisions/863f08cd6737?raw)