List transactions

GET

/v1/transactions/b2b

Transactions made with your API keys, newest first.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠400

🟠401

🟠403

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://localhost:5050/v1/transactions/b2b?type=&status=&channel=&search=&from=&to=&page=&limit=' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success

{
    "success": true,
    "message": "Request successful",
    "statusCode": 200,
    "path": "/v1/…",
    "timestamp": "2026-09-26T12:00:00.000Z",
    "hash": "a1b2c3d4-…",
    "data": {
        "data": [
            {
                "reference": "DB-DATA-20250923-MFX2K9QZ-7A3C9D21",
                "type": "DATA",
                "status": "SUCCESS",
                "amount": 480,
                "recipient": "08012345678",
                "network": "MTN",
                "planId": "7",
                "description": "1GB SME · 30 days",
                "tokenOrPin": null,
                "balanceBefore": 10000,
                "balanceAfter": 9520,
                "failureReason": null,
                "createdAt": "2026-09-26T12:00:00.000Z"
            }
        ],
        "meta": {
            "total": 1,
            "page": 1,
            "limit": 20,
            "pageCount": 1
        }
    }
}

Modified at 2026-10-05 17:27:33

Issue a virtual card

Get a transaction