Retrieve a transaction

GET

/transactions/{id}

Fetches a single ledger transaction by its unique identifier. The transaction must belong to the authenticated entity — the entity_id from the bearer token is automatically applied as a scoping condition, so callers cannot retrieve transactions belonging to other entities.

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 transaction was found and returned successfully.

Bodyapplication/json

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success

{
    "message": "Transaction retrieved successfully",
    "status": "success",
    "data": {
        "id": "01J3KQZM0000000000000000AB",
        "entity_id": "01H8XG7ZC0000000000000ENT1",
        "account_id": "01H8XG7ZC0000000000000ACC1",
        "direction": "outflow",
        "type": "payout",
        "amount": 5000,
        "currency": "NGN",
        "applicable_fee": 25,
        "balance_after": 194975,
        "status": "successful",
        "status_reason": null,
        "narration": "Payout to Jane Doe - Invoice #1042",
        "counterparty_id": "01H8XG7ZC0000000000CPRTY1",
        "initiating_counterparty": {
            "account_id": "01H8XG7ZC0000000000000ACC1",
            "account_name": "Acme Merchant Ltd"
        },
        "receiving_counterparty": {
            "name": "Jane Doe",
            "email": "jane.doe@example.com",
            "account_number": "0123456789",
            "bank_code": "058"
        },
        "source": {
            "type": "payout_intent_action",
            "id": "01H8XG7ZC0000000SRCACTION1"
        },
        "created": 1717689600000,
        "updated": 1717689600000
    }
}

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

Fund an entity's test wallet with sandbox test money

List transactions