Retrieve an account transfer

GET

/account-transfers/{id}

Fetches a single account transfer by its unique identifier. The transfer must belong to the authenticated entity — the entity_id from the bearer token is automatically applied as a scoping condition, so callers cannot retrieve account transfers belonging to other entities. Use this to check the current status, applied fees, and exchange rate of a transfer you previously created.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

The account transfer was found and returned successfully.

Bodyapplication/json

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/account-transfers/01J3KQZM0000000000000000AB' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "message": "Account transfer retrieved successfully",
    "status": "success",
    "data": {
        "id": "01J3KQZM0000000000000000AB",
        "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
        "source_account_id": "01HQZR2BKPFQ8MXJVT3G7LWNE",
        "destination_account_id": "01HQZR2BKPFQ8MXJVT3G7LWNF",
        "source_currency": "NGN",
        "amount": 50000,
        "destination_currency": "USD",
        "destination_amount": 32.5,
        "exchange_rate": 0.00065,
        "applicable_fee": 50,
        "quote_id": "01HQZR2BKPFQ8MXJVT3G7LWNG",
        "client_reference": "transfer-ref-20260812-001",
        "client_meta": {
            "invoice_id": "inv-88213"
        },
        "narration": "Working capital top-up",
        "status": "successful",
        "status_reason": null,
        "maker_checker_approver_group_id": null,
        "fully_approved_at": null,
        "created": 1786598200000,
        "updated": 1786598400000
    }
}

Modified at 2026-09-30 00:29:30

List account transfers

List all ACL roles