---
title: List transactions
description: Page through your project's ledger, most recent first.
api: GET /transactions
---

- **`type`** · query · `string`

  `collection`, `payout` or `refund`. Default: all.

- **`status`** · query · `string`

  `pending`, `successful` or `failed`. Default: all.

- **`page`** · query · `integer` · default `1`

  Which page, starting at 1. See [pagination](/docs/concepts/pagination).

- **`limit`** · query · `integer` · default `25`

  Results per page, up to 100.

- **`q`** · query · `string`

  Search by `external_reference`, description, phone number or payer/payee name. Case-insensitive, matches part of a value.

## Response

A [page](/docs/concepts/pagination) of [transactions](/docs/concepts/transactions#the-transaction-object), newest first.

- **`data`** · `array` · required

  The transactions on this page.

- **`page`** · `integer` · required

  The page returned.

- **`limit`** · `integer` · required

  The page size used.

- **`total`** · `integer` · required

  How many match the filters and search across all pages.

- **`total_pages`** · `integer` · required

  How many pages there are at this `limit`; `0` when nothing matches. Keep requesting while `page < total_pages`.

```json 200
{
  "success": true,
  "message": "",
  "data": {
    "data": [
      {
        "external_reference": "commission-2026-10-sipho",
        "type": "payout",
        "direction": "out",
        "provider_id": "momo",
        "amount": 250,
        "currency": "SZL",
        "status": "successful",
        "payee_phone": "26878123456",
        "party_name": "Sipho Dlamini",
        "metadata": {},
        "created_at": 1760774400,
        "updated_at": 1760774430
      }
    ],
    "page": 1,
    "limit": 25,
    "total": 1,
    "total_pages": 1
  }
}
```