List transactions

GET

https://api.staging.vrtx.sa/cl/v1/transactions

Last modified:2025-12-03 07:59:44

Retrieve all transactions recorded in the closed-loop system.
You can optionally filter results by account number, transaction type, status, or date range.

If no filters are applied, the endpoint returns all transactions in the system (paginated).
This endpoint is useful for reconciliation, reporting, and audit visibility across all internal movements — including funding, payouts, refunds, transfers, and withdrawals.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

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/cl/v1/transactions?business_id&wallet_id&account_number&external_reference&status&transaction_type&posted_from&posted_to&effective_from&effective_to&limit&cursor&type' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/json

Body

Example

{
    "url": "/v1/transactions",
    "data": [
        {
            "id": "630a552d-97e3-4ae0-8dc9-c373ee1fd86a",
            "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
            "external_reference": "WD-0012345",
            "description": "Withdraw: Cash-out",
            "status": "posted",
            "type": "withdrawal",
            "amount": "10.00",
            "amount_minor": 1000,
            "currency": "SAR",
            "posted_at": "2025-10-25T14:42:27.201Z",
            "created_at": "2025-10-25T14:42:27.201Z",
            "effective_date": "2025-10-25T00:00:00.000Z",
            "debit_wallet_id": "7eb7f5e0-1ecd-4bc7-83ec-d94eb6e49726",
            "debit_account_number": "054200001011",
            "credit_wallet_id": "6546c5d2-4fbb-44b4-afd2-f20742f553a5",
            "credit_account_number": "054200001029"
        },
        {
            "id": "ab17f685-3531-46f3-a200-02e9d2d07f41",
            "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
            "external_reference": "Transfer-1231233",
            "description": "Monthly settlement",
            "status": "posted",
            "type": "transfer",
            "amount": "1.00",
            "amount_minor": 100,
            "currency": "SAR",
            "posted_at": "2025-10-25T14:37:13.338Z",
            "created_at": "2025-10-25T14:37:13.338Z",
            "effective_date": "2025-10-25T00:00:00.000Z",
            "debit_wallet_id": "1e410c63-5614-4e7c-8d4a-b872871ac92a",
            "debit_account_number": "054200002027",
            "credit_wallet_id": "75304aff-2adc-4964-9ba8-a67eba92d311",
            "credit_account_number": "054200002019"
        },
        {
            "id": "4e0f5b1f-c449-4083-a408-bfe1355a3b6b",
            "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
            "external_reference": "REF-123456789",
            "description": "Refund: PO-0013579",
            "status": "posted",
            "type": "refund",
            "amount": "10.00",
            "amount_minor": 1000,
            "currency": "SAR",
            "posted_at": "2025-10-25T14:35:46.011Z",
            "created_at": "2025-10-25T14:35:46.011Z",
            "effective_date": "2025-10-25T00:00:00.000Z",
            "debit_wallet_id": "1e410c63-5614-4e7c-8d4a-b872871ac92a",
            "debit_account_number": "054200002027",
            "credit_wallet_id": "7eb7f5e0-1ecd-4bc7-83ec-d94eb6e49726",
            "credit_account_number": "054200001011"
        },
        {
            "id": "b6327558-741e-411c-866b-0eec8ea26005",
            "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
            "external_reference": "PO-0013579",
            "description": "Payout: Vendor settlement",
            "status": "posted",
            "type": "payout",
            "amount": "10.00",
            "amount_minor": 1000,
            "currency": "SAR",
            "posted_at": "2025-10-25T14:34:04.254Z",
            "created_at": "2025-10-25T14:34:04.254Z",
            "effective_date": "2025-10-25T00:00:00.000Z",
            "debit_wallet_id": "7eb7f5e0-1ecd-4bc7-83ec-d94eb6e49726",
            "debit_account_number": "054200001011",
            "credit_wallet_id": "1e410c63-5614-4e7c-8d4a-b872871ac92a",
            "credit_account_number": "054200002027"
        },
        {
            "id": "c31b124b-0034-4aec-a795-8a4ba3abf084",
            "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
            "external_reference": "WD-0011221",
            "description": "Withdraw: Cash-out",
            "status": "posted",
            "type": "withdrawal",
            "amount": "2.00",
            "amount_minor": 200,
            "currency": "SAR",
            "posted_at": "2025-10-25T09:03:48.612Z",
            "created_at": "2025-10-25T09:03:48.612Z",
            "effective_date": "2025-10-25T00:00:00.000Z",
            "debit_wallet_id": "1e410c63-5614-4e7c-8d4a-b872871ac92a",
            "debit_account_number": "054200002027",
            "credit_wallet_id": "6546c5d2-4fbb-44b4-afd2-f20742f553a5",
            "credit_account_number": "054200001029"
        },
        {
            "id": "104f4d45-3cac-4dad-9bdb-d344c6f84e2f",
            "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
            "external_reference": "Fees-invoice-12344",
            "description": "Monthly settlement",
            "status": "posted",
            "type": "transfer",
            "amount": "0.50",
            "amount_minor": 50,
            "currency": "SAR",
            "posted_at": "2025-10-25T08:51:20.005Z",
            "created_at": "2025-10-25T08:51:20.005Z",
            "effective_date": "2025-10-25T00:00:00.000Z",
            "debit_wallet_id": "75304aff-2adc-4964-9ba8-a67eba92d311",
            "debit_account_number": "054200002019",
            "credit_wallet_id": "1e410c63-5614-4e7c-8d4a-b872871ac92a",
            "credit_account_number": "054200002027"
        },
        {
            "id": "71cc97ca-f5a4-4e0f-8895-3e8fb782b78e",
            "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
            "external_reference": "REFUND-INV-1232",
            "description": "Refund: PO-001234",
            "status": "posted",
            "type": "refund",
            "amount": "1.00",
            "amount_minor": 100,
            "currency": "SAR",
            "posted_at": "2025-10-25T08:35:03.944Z",
            "created_at": "2025-10-25T08:35:03.944Z",
            "effective_date": "2025-10-25T00:00:00.000Z",
            "debit_wallet_id": "1e410c63-5614-4e7c-8d4a-b872871ac92a",
            "debit_account_number": "054200002027",
            "credit_wallet_id": "7eb7f5e0-1ecd-4bc7-83ec-d94eb6e49726",
            "credit_account_number": "054200001011"
        },
        {
            "id": "4fca935b-7c2f-4f6d-a376-7a9969e2e82b",
            "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
            "external_reference": "PO-001234",
            "description": "Payout: Vendor settlement",
            "status": "posted",
            "type": "payout",
            "amount": "1.00",
            "amount_minor": 100,
            "currency": "SAR",
            "posted_at": "2025-10-25T08:25:41.344Z",
            "created_at": "2025-10-25T08:25:41.344Z",
            "effective_date": "2025-10-25T00:00:00.000Z",
            "debit_wallet_id": "7eb7f5e0-1ecd-4bc7-83ec-d94eb6e49726",
            "debit_account_number": "054200001011",
            "credit_wallet_id": "1e410c63-5614-4e7c-8d4a-b872871ac92a",
            "credit_account_number": "054200002027"
        },
        {
            "id": "e1cfc53e-b0af-4bdf-b33a-2ee7100a613a",
            "business_id": "9fa5cea8-6edb-4196-800f-8809e08f1365",
            "external_reference": "INV-12345111",
            "description": "Fund: Funding for marketplace float",
            "status": "posted",
            "type": "fund",
            "amount": "1000.00",
            "amount_minor": 100000,
            "currency": "SAR",
            "posted_at": "2025-10-25T07:48:18.345Z",
            "created_at": "2025-10-25T07:48:18.345Z",
            "effective_date": "2025-10-25T00:00:00.000Z",
            "debit_wallet_id": "89dc25e6-1c92-4fc7-b533-1f1c76c13f58",
            "debit_account_number": "099800003032",
            "credit_wallet_id": "1184dd97-0a2f-410f-9c3c-3e3da3aa778d",
            "credit_account_number": "099800003024"
        },
        {
            "id": "bd055b28-5ae0-44e6-bf5c-ad5856caa039",
            "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
            "external_reference": "WD-001",
            "description": "Withdraw: Cash-out",
            "status": "posted",
            "type": "withdrawal",
            "amount": "50.00",
            "amount_minor": 5000,
            "currency": "SAR",
            "posted_at": "2025-10-25T06:45:56.110Z",
            "created_at": "2025-10-25T06:45:56.110Z",
            "effective_date": "2025-10-25T00:00:00.000Z",
            "debit_wallet_id": "7eb7f5e0-1ecd-4bc7-83ec-d94eb6e49726",
            "debit_account_number": "054200001011",
            "credit_wallet_id": "6546c5d2-4fbb-44b4-afd2-f20742f553a5",
            "credit_account_number": "054200001029"
        }
    ],
    "has_more": true,
    "next_cursor": "MjAyNS0xMC0yNVQwNjo0NTo1Ni4xMTA0MTNafGJkMDU1YjI4LTVhZTAtNDRlNi1iZjVjLWFkNTg1NmNhYTAzOXw1"
}

🟠401Unauthorized

🟠403Forbidden

Modified at 2025-12-03 07:59:44

Create label

Get transaction