List wallet transactions

GET

https://api.staging.vrtx.sa/customers/{customer_id}/wallet/transactions

Last modified:2025-12-03 10:51:05

Returns paginated list of transactions for a customer's wallet account.

Supports the same advanced filtering provided for business accounts:

Date range filters (start_date, end_date)

Transaction type filtering (fund, m2p_payout)

Cursor-based pagination with configurable page size

Sorted by newest transaction first

Error Scenarios:

404: Wallet account not found for the provided customer

Request

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.staging.vrtx.sa/customers//wallet/transactions?start_date&end_date&type&limit&cursor'

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

Modified at 2025-12-03 10:51:05

Get wallet balance

Initiate card replacement