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
      • Get transaction details
        GET
      • List business transactions
        GET
  • Business Configurations
    • Get business configurations
      GET
  • Whitelist
    • Add whitelist entries
      POST
    • Get whitelist entries
      GET
    • Delete whitelist entries
      DELETE
Client APIs
Vrtx Closed loopCard Simulator
Client APIs
Vrtx Closed loopCard Simulator
  1. Business Accounts

List business transactions

GET
https://api.staging.vrtx.sa/businesses/accounts/{account_id}/transactions
Last modified:2026-04-20 16:14:42
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

Path Params

Query Params

Responses

🟢200OK
application/json
Default Response
Body

đźź 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
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.staging.vrtx.sa/businesses/accounts//transactions?start_date&end_date&type&limit&cursor'
Response Response Example
200 - Example 1
{
    "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:22.123Z",
            "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"
    }
}
Modified at 2026-04-20 16:14:42
Previous
Get transaction details
Next
Get business configurations
Built with