List account transfers

GET

/account-transfers

Returns a paginated list of account transfers belonging to the authenticated entity, ordered newest first. An account transfer moves funds between two accounts owned by the same entity, optionally converting currency along the way. Use the optional account_id query parameter to filter transfers where the given account was either the source or the destination. Pagination is cursor-based: each response includes a meta.pagination.cursor value that you pass as the cursor query parameter on the next request to fetch the following page. When meta.pagination.has_more is false, you have reached the end of the list.

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 ********************

Query Params

Responses

🟢200

application/json

Account transfers retrieved successfully. Returns a page of transfers and pagination metadata.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location '/account-transfers?account_id=01HQZR2BKPFQ8MXJVT3G7LWNB&cursor=01HQZR2BKPFQ8MXJVT3G7LWNE&limit=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - First page — more results available

{
    "message": "Account transfers retrieved successfully",
    "status": "success",
    "data": [
        {
            "id": "01HQZR2BKPFQ8MXJVT3G7LWNZ",
            "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
            "source_account_id": "01HQZR2BKPFQ8MXJVT3G7LWNB",
            "destination_account_id": "01HQZR2BKPFQ8MXJVT3G7LWNC",
            "source_currency": "NGN",
            "amount": 50000,
            "destination_currency": "USD",
            "destination_amount": 32.5,
            "exchange_rate": 0.00065,
            "applicable_fee": 100,
            "quote_id": "01HQZR2BKPFQ8MXJVT3G7LWND",
            "client_reference": "transfer-2026-0091",
            "client_meta": {
                "purpose": "internal-treasury-sweep"
            },
            "narration": "Monthly treasury sweep",
            "status": "successful",
            "status_reason": null,
            "maker_checker_approver_group_id": null,
            "fully_approved_at": null,
            "created": 1754524800000,
            "updated": 1754524800000
        }
    ],
    "meta": {
        "pagination": {
            "cursor": "01HQZR2BKPFQ8MXJVT3G7LWNZ",
            "has_more": true
        }
    }
}

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

Create an account transfer

Retrieve an account transfer