---
title: "Get all transactions"
method: GET
path: "/transactions"
tags: ["Transaction"]
---

# Get all transactions

`GET /transactions`

Returns all transactions with pagination and filtering options

## Query parameters

- `page` integer
- `limit` integer
- `txId` string, uuid
- `accountName` string
- `status` 'SUCCESS' | 'PENDING' | 'FAILED'
- `type` 'WITHDRAWAL' | 'DEPOSIT'
- `currency` 'NGN' | 'KES' | 'ZAR' | 'USDT'
- `minAmount` integer
- `maxAmount` integer
- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

Transaction response with pagination

- object
  - `status` string
  - `message` string
  - `count` integer — Total number of transactions
  - `nextPage` boolean — Whether there is a next page available
  - `currentPage` integer — Current page number
  - `remainingPage` integer — Number of remaining pages
  - `totalPages` integer — Total number of pages
  - `data` TransactionResponse[]
    - `id` string, uuid
    - `ref` string
    - `hash` string
    - `amount` number
    - `fees` number
    - `currency` 'NGN' | 'KES' | 'BTC' | 'ZAR' | 'USDT'
    - `type` 'WITHDRAWAL' | 'DEPOSIT'
    - `status` 'SUCCESS' | 'PENDING' | 'FAILED'
    - `autopayout` boolean
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `metadata` object
      - `id` string, uuid
      - `merchantId` string, uuid
      - `merchantName` string
      - `bankName` string
      - `bankAccountNumber` string
      - `reference` string
      - `customerInternalFee` number
      - `order` object
        - `id` string
        - `settledQuoteId` string, uuid
        - `amount` number
        - `currency` 'NGN' | 'KES' | 'ZAR'
        - `paymentMethod` 'LIGHTNING'
        - `status` 'PAID' | 'PENDING' | 'EXPIRED' | 'FAILED'
        - `quote` object
          - `id` string, uuid
          - `exchangeRate` number
          - `usdToTargetCurrencyRate` number
          - `paymentBtcDetail` string
          - `paymentMethod` 'LIGHTNING'
          - `totalAmount` number
          - `equivalentAmount` number
          - `expiry` string, date-time
          - `sourceCurrency` 'BTCSAT'
          - `targetCurrency` 'NGNKOBO' | 'KESCENT' | 'ZARCENT'
          - `paymentCurrency` 'NGNKOBO' | 'KESCENT' | 'ZARCENT'
          - `customerInternalFee` number

## Other responses

- `400` — Unexpected error

## Changes

- **2026-08-20** `842376cab855` — 1 warning, 1 info
  - added the new `USDT` enum value to the `data/items/currency` response property for the response status `200`
  - added the new enum value `USDT` to the `query` request parameter `currency`
- **2026-01-13** `49368798ec50` — 1 info
  - the `query` request parameter `currency` became optional
- **2025-02-25** `295a24f2c261` — 1 info
  - added the new optional `query` request parameter `currency`
- **2025-02-25** `f3878f349317` — 1 breaking, 17 info
  - the `status` response's property type/format changed from `string`/`string` to `string`/`` for status `200`
  - added the new optional `query` request parameter `accountName`
  - added the new optional `query` request parameter `endDate`
  - added the new optional `query` request parameter `limit`
  - …14 more
- **2025-02-01** `7b7e4fa5fe46` — 8 breaking, 2 warning, 1 info
  - the `data/items/amount` response's property type/format changed from `number`/`number` to `number`/`` for status `200`
  - the `data/items/autopayout` response's property type/format changed from `boolean`/`boolean` to `boolean`/`` for status `200`
  - the `data/items/currency` response's property type/format changed from `string`/`string` to `string`/`` for status `200`
  - the `data/items/fees` response's property type/format changed from `number`/`number` to `number`/`` for status `200`
  - …7 more

[Full history](https://skmtc.dev/stealthmoney/apis/mavapay-api/changes/transactions/get.md)

---

[API](https://skmtc.dev/stealthmoney/apis/mavapay-api.md) · [All operations](https://skmtc.dev/stealthmoney/apis/mavapay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stealthmoney/mavapay-api/revisions/842376cab855/schema)