vrtx Docs
Core APIs
  • Start
  • Onboarding
  • Wallet
  • Payouts
  • Cards
  • Transactions
Closed loop APIsCard Simulator
SDK APIs
  • Coming Soon!
Core APIs
  • Start
  • Onboarding
  • Wallet
  • Payouts
  • Cards
  • Transactions
Closed loop APIsCard Simulator
SDK APIs
  • Coming Soon!
  1. Wallet Accounts
  • Welcome 👋
  • Get Started
  • Auth
    • Token
      POST
  • Onboarding
    • Start onboarding
      POST
    • Verify onboarding OTP
      POST
    • Resend onboarding OTP
      POST
    • Get session status
      GET
    • Initiate Nafath
      POST
    • Cancels session
      POST
    • Complete customer info
      POST
  • Wallet
    • Change mobile number from profile settings
      • Change mobile number
      • Verify mobile number change OTP
      • Get mobile change status
    • Change mobile number from login screen
      • Change mobile number
      • Verify mobile number change OTP
      • Initiate Nafath
      • Get mobile number change status
  • Payouts
    • Create payout
      POST
    • Get payout status
      GET
    • Create bulk payout
      POST
    • Get bulk payout status
      GET
    • Get batch report
      GET
  • Cards
    • Issuance
      • Issue card
      • Get card issuance
      • Complete card issuance
      • Verify card issuance OTP
      • Convert virtual to physical
      • Verify card conversion OTP
    • Management
      • Get card
      • Change card status
      • Set or update card PIN
      • Verify card PIN OTP
      • Activate physical card
      • Verify activation OTP
      • Display sensitive data
      • Verify display sensitive data OTP
  • Transactions
    • Business Accounts
      • Get business account balance
      • Get transaction details
      • List business transactions
    • Wallet Accounts
      • Get wallet balance
        GET
      • List wallet transactions
        GET
  • cards
    • Initiate card replacement
    • Verify OTP and complete card replacement
  1. Wallet Accounts

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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
Previous
Get wallet balance
Next
Initiate card replacement
Built with