Check a data purchase

GET

/v1/data/b2b/{reference}

The current status of a data purchase. While it is PROCESSING this checks with the network, so poll it (every 10–30 seconds is plenty) until it is SUCCESS or FAILED.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Path Params

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://localhost:5050/v1/data/b2b/' \
--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": {
        "reference": "DB-DATA-20250923-MFX2K9QZ-7A3C9D21",
        "type": "DATA",
        "status": "PROCESSING",
        "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"
    }
}

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

List data plans

Get wallet balance