1. Business Accounts
Vrtx Docs
  • Welcome 👋
  • Get Started
  • Auth
    • Token
      POST
  • Payouts
    • Create payout
      POST
    • Get payout status
      GET
    • Create bulk payout
      POST
    • Get bulk payout status
      GET
    • Get batch report
      GET
  • Transactions
    • Business Accounts
      • Get business account balance
        GET
      • List business transactions
        GET
      • Get transaction details by reference
        GET
  • Whitelist
    • Add whitelist entries
      POST
    • Get whitelist entries
      GET
    • Delete whitelist entries
      DELETE
  • Wallets
    • List Wallets
      GET
    • Get Wallet
      GET
Vrtx APIs
Vrtx Closed loop
Vrtx APIs
Vrtx Closed loop
  1. Business Accounts

List business transactions

GET
https://api.sandbox.vrtx.sa/businesses/accounts/transactions
Last modified:2026-08-24 10:04:05
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

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Query Params

Responses

🟢200Fund
application/json
Default Response
Bodyapplication/json

🟢200Payout
🟠400
🟠401
🟠403
🟠404
🟠405
🟠409
🟠410
🟠422
🟠429
🔴500
🔴501
🔴503
🔴504
🔴505
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.sandbox.vrtx.sa/businesses/accounts/transactions' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Success
{
    "data": [
        {
            "transaction_reference": "fund_10013335e1f1b",
            "transaction_type": "fund",
            "source_account_number": "world",
            "destination_account_number": "REF_bus_5989620",
            "destination_external_reference": "",
            "sender_id": "world",
            "receiver_id": "REF_bus_5989620",
            "amount": "100.00",
            "balance": "3166481.94",
            "direction": "credit",
            "currency": "SAR",
            "created_at": "2026-05-12T13:10:11.508Z",
            "description": "Topup via ANB credit",
            "beneficiary_details": {
                "iban": "",
                "beneficiary_name": "HAMH HR ANUAES ERCOR CE O"
            },
            "internal_id": "38951"
        },
        {
            "transaction_reference": "fund_100bfb8feceac",
            "transaction_type": "fund",
            "source_account_number": "world",
            "destination_account_number": "REF_bus_5989620",
            "destination_external_reference": "",
            "sender_id": "world",
            "receiver_id": "REF_bus_5989620",
            "amount": "200.00",
            "balance": "3166381.94",
            "direction": "credit",
            "currency": "SAR",
            "created_at": "2026-05-12T13:10:11.436Z",
            "description": "Topup via ANB credit",
            "beneficiary_details": {
                "iban": "",
                "beneficiary_name": "HAMH HR ANUAES ERCOR CE O"
            },
            "internal_id": "38950"
        },
        {
            "transaction_reference": "fund_10049a927c9ef",
            "transaction_type": "fund",
            "source_account_number": "world",
            "destination_account_number": "REF_bus_5989620",
            "destination_external_reference": "",
            "sender_id": "world",
            "receiver_id": "REF_bus_5989620",
            "amount": "62500.00",
            "balance": "3166181.94",
            "direction": "credit",
            "currency": "SAR",
            "created_at": "2026-05-12T12:55:10.873Z",
            "description": "Topup via ANB credit",
            "beneficiary_details": {
                "iban": "0108057386290014",
                "beneficiary_name": "HAMH HR ANUAES ERCOR CE O"
            },
            "internal_id": "38949"
        },
        {
            "transaction_reference": "fund_100894dd6ba79",
            "transaction_type": "fund",
            "source_account_number": "world",
            "destination_account_number": "REF_bus_5989620",
            "destination_external_reference": "",
            "sender_id": "world",
            "receiver_id": "REF_bus_5989620",
            "amount": "678.90",
            "balance": "3103681.94",
            "direction": "credit",
            "currency": "SAR",
            "created_at": "2026-05-12T12:00:08.049Z",
            "description": "Topup via ANB credit",
            "beneficiary_details": {
                "iban": "I011660104991051",
                "beneficiary_name": "HAMH HR ANUAES ERCOR CE O"
            },
            "internal_id": "38948"
        },
        {
            "transaction_reference": "fund_1009653928973",
            "transaction_type": "fund",
            "source_account_number": "world",
            "destination_account_number": "REF_bus_5989620",
            "destination_external_reference": "",
            "sender_id": "world",
            "receiver_id": "REF_bus_5989620",
            "amount": "444.44",
            "balance": "3103003.04",
            "direction": "credit",
            "currency": "SAR",
            "created_at": "2026-05-12T12:00:07.998Z",
            "description": "Topup via ANB credit",
            "beneficiary_details": {
                "iban": "I011660104991051",
                "beneficiary_name": "HAMH HR ANUAES ERCOR CE O"
            },
            "internal_id": "38947"
        },
        {
            "transaction_reference": "fund_1008696fb32d5",
            "transaction_type": "fund",
            "source_account_number": "world",
            "destination_account_number": "REF_bus_5989620",
            "destination_external_reference": "",
            "sender_id": "world",
            "receiver_id": "REF_bus_5989620",
            "amount": "2574.50",
            "balance": "3102558.60",
            "direction": "credit",
            "currency": "SAR",
            "created_at": "2026-05-12T11:35:09.296Z",
            "description": "Topup via ANB credit",
            "beneficiary_details": {
                "iban": "I011660104991051",
                "beneficiary_name": "HAMH HR ANUAES ERCOR CE O"
            },
            "internal_id": "38946"
        },
        {
            "transaction_reference": "fund_10045c4bcc3f3",
            "transaction_type": "fund",
            "source_account_number": "world",
            "destination_account_number": "REF_bus_5989620",
            "destination_external_reference": "",
            "sender_id": "world",
            "receiver_id": "REF_bus_5989620",
            "amount": "74.00",
            "balance": "3099984.10",
            "direction": "credit",
            "currency": "SAR",
            "created_at": "2026-05-12T11:35:09.245Z",
            "description": "Topup via ANB credit",
            "beneficiary_details": {
                "iban": "I011660104991051",
                "beneficiary_name": "HAMH HR ANUAES ERCOR CE O"
            },
            "internal_id": "38945"
        },
        {
            "transaction_reference": "fund_1001038a2e355",
            "transaction_type": "fund",
            "source_account_number": "world",
            "destination_account_number": "REF_bus_5989620",
            "destination_external_reference": "",
            "sender_id": "world",
            "receiver_id": "REF_bus_5989620",
            "amount": "100.00",
            "balance": "3099910.10",
            "direction": "credit",
            "currency": "SAR",
            "created_at": "2026-05-12T11:35:09.200Z",
            "description": "Topup via ANB credit",
            "beneficiary_details": {
                "iban": "I011660104991051",
                "beneficiary_name": "HAMH HR ANUAES ERCOR CE O"
            },
            "internal_id": "38944"
        },
        {
            "transaction_reference": "fund_1005b4405720c",
            "transaction_type": "fund",
            "source_account_number": "world",
            "destination_account_number": "REF_bus_5989620",
            "destination_external_reference": "",
            "sender_id": "world",
            "receiver_id": "REF_bus_5989620",
            "amount": "123.45",
            "balance": "3099810.10",
            "direction": "credit",
            "currency": "SAR",
            "created_at": "2026-05-12T11:35:09.155Z",
            "description": "Topup via ANB credit",
            "beneficiary_details": {
                "iban": "I011660104991051",
                "beneficiary_name": "HAMH HR ANUAES ERCOR CE O"
            },
            "internal_id": "38943"
        },
        {
            "transaction_reference": "fund_10084835fbb65",
            "transaction_type": "fund",
            "source_account_number": "world",
            "destination_account_number": "REF_bus_5989620",
            "destination_external_reference": "",
            "sender_id": "world",
            "receiver_id": "REF_bus_5989620",
            "amount": "1574.00",
            "balance": "3099686.65",
            "direction": "credit",
            "currency": "SAR",
            "created_at": "2026-05-12T11:35:09.126Z",
            "description": "Topup via ANB credit",
            "beneficiary_details": {
                "iban": "I011660104991051",
                "beneficiary_name": "HAMH HR ANUAES ERCOR CE O"
            },
            "internal_id": "38942"
        }
    ],
    "pagination": {
        "page_size": 10,
        "has_next": true,
        "has_prev": false,
        "next_cursor": "eyJwYWdlU2l6ZSI6MTAsImJvdHRvbSI6Mzg5NTEsImNvbHVtbiI6ImlkIiwicGFnaW5hdGlvbklEIjozODk0MSwib3JkZXIiOjEsImZpbHRlcnMiOnsicGl0IjpudWxsLCJvb3QiOm51bGwsInFiIjp7IiRhbmQiOlt7IiRvciI6W3siJG1hdGNoIjp7InNvdXJjZSI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJkZXN0aW5hdGlvbiI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJtZXRhZGF0YVtzb3VyY2VfcmVmZXJlbmNlX2lkXSI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJtZXRhZGF0YVtkZXN0aW5hdGlvbl9yZWZlcmVuY2VfaWRdIjoiMTEwMDE4MjcxMDE3In19LHsiJG1hdGNoIjp7Im1ldGFkYXRhW2Rlc3RpbmF0aW9uX2FjY291bnRfbnVtYmVyXSI6IjExMDAxODI3MTAxNyJ9fSx7IiRtYXRjaCI6eyJtZXRhZGF0YVtzb3VyY2VfYWNjb3VudF9udW1iZXJdIjoiMTEwMDE4MjcxMDE3In19LHsiJG1hdGNoIjp7InNvdXJjZSI6IjExMDAxODI3MTAxNzpwZW5kaW5nIn19LHsiJG1hdGNoIjp7ImRlc3RpbmF0aW9uIjoiMTEwMDE4MjcxMDE3OnBlbmRpbmcifX0seyIkbWF0Y2giOnsic291cmNlIjoiMTEwMDE4MjcxMDE3OmhvbGQifX0seyIkbWF0Y2giOnsiZGVzdGluYXRpb24iOiIxMTAwMTgyNzEwMTc6aG9sZCJ9fV19LHsiJG1hdGNoIjp7Im1ldGFkYXRhW3R5cGVdIjoiUFJFRlVORCJ9fV19LCJleHBhbmQiOlsidm9sdW1lcyJdLCJvcHRzIjpudWxsfSwicmV2ZXJzZSI6ZmFsc2V9"
    }
}
Modified at 2026-08-24 10:04:05
Previous
Get business account balance
Next
Get transaction details by reference
Built with