Get transaction details by reference

GET

https://api.sandbox.vrtx.sa/businesses/accounts/transactions/{transaction_reference}

Last modified:2026-08-24 10:06:14

Retrieves detailed information about a specific fund or payout transaction,
looked up by its external transaction reference (e.g. network ref, ANB ref).

The owning business is resolved from the JWT (businessId claim). A reference
that does not belong to the authenticated business returns 404 so foreign
reference existence is not leaked.

Response includes:

Internal Formance ledger reference (internal_id)

Transaction type, direction, amount, balance, currency

Transaction parties (sender/receiver)

Type-specific fields (description for payouts, FAST/merchant fields for card flows)

Timestamps and audit information

Transaction Types:

Prefund: Money coming into business account from bank (credit)

M2P_Payout: Money going out from business to individual wallet (debit)

Error Scenarios:

404: Transaction reference not found for this business, or account not found

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path 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 Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.sandbox.vrtx.sa/businesses/accounts/transactions/payout_100b73ff57ff6' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "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"
}

Modified at 2026-08-24 10:06:14

List business transactions

Add whitelist entries