List data PIN plans

GET

/v1/datapin/b2b/plans

The plans you can generate PINs for, and what each PIN costs you. PIN prices are set separately from direct data prices. You are charged when a PIN is dialled, at the price at that moment.

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/datapin/b2b/plans?network=' \
--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": [
        {
            "planId": "MTN-1GB-30D",
            "network": "MTN",
            "dataType": "SME",
            "name": "1GB · 30 days",
            "size": "1GB",
            "validity": "30 days",
            "pinPrice": 300,
            "price": 285,
            "discountPercent": 5,
            "status": "AVAILABLE",
            "generationDisabled": false
        }
    ]
}

Modified at 2026-10-07 16:02:56

List your PIN batches

Your PIN generation limits