List transactions

GET

/transactions

Returns a paginated list of ledger transactions belonging to the authenticated entity, ordered newest first. A transaction is the immutable ledger record created whenever money moves in or out of one of your accounts — for example a settled payment, a disbursed payout, a sandbox test-money credit, or an internal account transfer. Use the optional query parameters to filter by account, direction, business type, status, originating intent, free-text search, or a creation date range. Pagination is cursor-based: pass the cursor value from the previous response's meta.pagination.cursor field as the cursor query parameter to fetch the next page. When has_more is false, you have reached the end of the list.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Transactions retrieved successfully. Returns a page of transactions and pagination metadata.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location '/transactions?account_id=01HQZR2BKPFQ8MXJVT3G7LWNC&direction=outflow&type=payout&status=successful&statuses=pending%2Csuccessful&search=vendor%20reimbursement&payment_intent_id=01HQZR2BKPFQ8MXJVT3G7LWNE&payout_intent_id=01HQZR2BKPFQ8MXJVT3G7LWND&created_from=1754000000000&created_to=1754600000000&include_total=true&cursor=01HQZR2BKPFQ8MXJVT3G7LWNZ&limit=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - First page — more results available

{
    "message": "Transactions retrieved successfully",
    "status": "success",
    "data": [
        {
            "id": "01HQZR2BKPFQ8MXJVT3G7LWNZ",
            "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
            "account_id": "01HQZR2BKPFQ8MXJVT3G7LWNC",
            "direction": "outflow",
            "type": "payout",
            "amount": 250000,
            "currency": "NGN",
            "applicable_fee": 500,
            "balance_after": 4750000,
            "status": "successful",
            "status_reason": null,
            "narration": "Vendor reimbursement for Q3 services",
            "counterparty_id": "01HQZR2BKPFQ8MXJVT3G7LWNF",
            "initiating_counterparty": {
                "name": "Acme Inc",
                "account_name": "Acme Inc Operating Account"
            },
            "receiving_counterparty": {
                "name": "Vendor Ltd",
                "account_number": "0123456789",
                "bank_code": "044"
            },
            "source": {
                "type": "payout_intent_action",
                "id": "01HQZR2BKPFQ8MXJVT3G7LWNG"
            },
            "created": 1754524800000,
            "updated": 1754524800000
        }
    ],
    "meta": {
        "pagination": {
            "cursor": "01HQZR2BKPFQ8MXJVT3G7LWNZ",
            "has_more": true,
            "total": null
        }
    }
}

Modified at 2026-09-30 00:29:30

Retrieve a transaction

List a virtual card's activity