---
title: "List all transactions"
method: GET
path: "/transactions"
tags: ["Transactions"]
---

# List all transactions

`GET /transactions`

## Request

- Base URL: `https://api.sandbox.zeptopayments.com`
- URL: `https://api.sandbox.zeptopayments.com/transactions`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token`

<aside class="notice">By default, Zepto will search and return all transactions created in the <strong>last 30 days</strong>. You can adjust this up to <strong>1 year</strong> by defining the <code>min_created_date</code> query string parameter defined below.</aside>

## Query parameters

- `page` string
- `per_page` string
- `ref (debit or credit)` string
- `parent_ref` string
- `bank_ref` string
- `both_parties` boolean
- `status` string[]
- `category` string[]
- `type` string[]
- `other_party` string
- `other_party_bank_ref` string
- `party_contact_id` string
- `description` string
- `min_amount` integer
- `max_amount` integer
- `min_created_date` string, date-time
- `max_created_date` string, date-time
- `min_matured_date` string, date-time
- `max_matured_date` string, date-time
- `min_cleared_date` string, date-time
- `max_cleared_date` string, date-time
- `min_status_changed_date` string, date-time
- `max_status_changed_date` string, date-time

## Response `200`

OK

- ListAllTransactionsResponse
  - `data` TransactionResponse[], required
    - `ref` string, required: The ref of the transaction (`C.*` or `D.*`)
    - `parent_ref` string, nullable, required: The ref of the parent of this transaction
    - `type` 'credit' | 'debit', required: The type of the transaction
    - `category` 'payout' | 'payout_refund' | 'invoice' | 'payout_reversal' | 'transfer' | 'recovery', required: The category of the transaction
    - `created_at` string, date-time, required: When the transaction was created
    - `matures_at` string, date-time: When the transaction was processed
    - `cleared_at` string, date-time, nullable, required: When the transaction was cleared
    - `bank_ref` string, nullable, required: The ref that is sent to the bank
    - `status` 'maturing' | 'matured' | 'preprocessing' | 'processing' | 'clearing' | 'cleared' | 'rejected' | 'returned' | 'voided' | 'pending_verification' | 'paused' | 'channel_switched', required: The status of the transaction (see [Transactions/Lifecycle](#lifecycle-4) for more info)
    - `status_changed_at` string, required: When the status was last changed
    - `failure_details` string: Details if a failure occured
    - `failure` Failure
      - `code` string, required
      - `title` string, required
      - `detail` string, required
    - `party_contact_id` string, uuid, required: The transaction party's contact ID
    - `party_name` string, required: The transaction party's name
    - `party_nickname` string, nullable, required: The transaction party's nickname
    - `party_bank_ref` string, nullable, required: The transaction party's bank ref
    - `description` string, nullable, required: The transaction's description
    - `amount` integer, required: Amount in cents (Min: 1 - Max: 99999999999)
    - `bank_account_id` string, uuid, required: The bank account ID of this transaction
    - `channels` unknown[], required: Which payment channels this transaction can use (see [Payments/Make a payment](#make-a-payment) for more info)
      - unknown
    - `current_channel` 'direct_entry' | 'float_account' | 'new_payments_platform', required: The current payment channel in use for this transaction
    - `reversal_details` object: Reversal details (see [Payments/Lifecyle](#lifecycle-3) for more info)
      - `source_debit_ref` string: The source debit ref of the reversal
      - `source_credit_failure` Failure
        - `code` string, required
        - `title` string, required
        - `detail` string, required
    - `metadata` Metadata: Use for your custom data and certain Zepto customisations.

## Changes

- **2026-11-03** `75ced198de22`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zeptopayments/apis/zepto-api/changes/transactions/get.md)

---

[API](https://skmtc.dev/zeptopayments/apis/zepto-api.md) - [All operations](https://skmtc.dev/zeptopayments/apis/zepto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zeptopayments/apis/zepto-api/revisions/75ced198de22?raw)