List business transactions

Returns paginated list of SUCCESSFUL transactions for a business account.

This endpoint provides comprehensive transaction history with advanced filtering and cursor-based pagination.

Query Parameters:

start_date/end_date: ISO-8601 date range filters (e.g., 2025-05-01). If not provided, defaults to today's date.

type: Comma-separated transaction types (fund, payout)

limit: Results per page (1-200, default 10)

cursor: Pagination cursor for next page

Features:

Date Range Filtering: Inclusive date filtering with automatic default to today

Transaction Type Filtering: Filter by fund transactions and payout transfers

Cursor-Based Pagination: Efficient pagination for large result sets

Sorted Results: Transactions sorted by created_at desc (most recent first)

Response Format:

data: Array of transaction details (same format as single transaction endpoint)

pagination: Cursor-based pagination metadata with next/prev cursors

Error Scenarios:

400: Invalid date format, invalid type values, invalid cursor

404: Account not found

Responses

🟢200OK

application/json

Default Response

Body

Example

{
    "data": [
        {
            "transaction_id": "string",
            "transaction_type": "fund",
            "sender_id": "string",
            "receiver_id": "string",
            "amount": "string",
            "balance": "string",
            "direction": "debit",
            "currency": "SAR",
            "created_at": "2019-08-24T14:15:22Z",
            "description": "string",
            "transaction_reference": "string",
            "status": "Approved",
            "auth_status": "PENDING",
            "merchant": {
                "name": "string",
                "mcc": "string",
                "category": "string",
                "country": "string"
            },
            "network": "string",
            "rrn": "string",
            "terminal_id": "string"
        }
    ],
    "pagination": {
        "page_size": 0,
        "has_next": true,
        "has_prev": true,
        "next_cursor": "string",
        "prev_cursor": "string"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠405Method Not Allowed

🟠409Conflict

🟠410Gone

🟠422Unprocessable Entity

🟠429Too Many Requests

🔴500Internal Server Error

🔴501Not Implemented

🔴503Service Unavailable

🔴504Gateway Timeout

🔴505HTTP Version Not Supported

List business transactions

Request

Request Code Samples

Responses