SME & Corporate Data API

Purchase high-speed SME, Corporate Gifting, and CG data bundles at wholesale tiered prices with instant delivery.

Supported Networks & Discount Rates

NETWORK	NETWORK CODE	AVAILABLE PLAN TYPES	DISCOUNT (BASE PRICE)	STATUS
MTN Nigeria	MTN	`SME`, `CG`, `GIFTING`	20.0%	Active
Airtel Nigeria	AIRTEL	`CG`, `GIFTING`	20.0%	Active
Glo Nigeria	GLO	`CG`, `GIFTING`	20.0%	Active
9mobile Nigeria	9MOBILE	`CG`, `GIFTING`	20.0%	Active

Step 1: Fetch SME Data Plans

Query dynamic SME data variations with pricing personalized to your account role tier.

GET /api/v1/sme-data/variations?network=MTN

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`network`	string	Filter by network: `MTN`, `AIRTEL`, `GLO`, `9MOBILE`.	Optional
`type`	string	Filter by plan type: `SME`, `CG`, `CORPORATE`, `GIFTING`.	Optional

Step 2: Purchase SME Data

POST /api/v1/sme-data/purchase

Authentication & Headers

HEADER	VALUE	REQUIRED
`Authorization`	`Bearer YOUR_API_TOKEN`	Yes
`Content-Type`	`application/json`	Yes

Request Parameters

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`network`	string	Telecom network: `MTN`, `AIRTEL`, `GLO`, or `9MOBILE`.	Required
`mobileno`	string	11-digit Nigerian recipient mobile number (e.g. `08012345678`).	Required
`plan_id`	string	The unique `data_id` identifier of the plan from Step 1 (e.g. `1`, `204`).	Required
`request_id`	string	Optional unique reference ID for duplicate prevention and idempotency.	Optional

Sample Request Payload

JSON

{
    "network": "MTN",
    "mobileno": "08012345678",
    "plan_id": "1",
    "request_id": "REQ_SME_84920"
}

Success Response (200 OK)

{
    "status": "success",
    "code": 200,
    "message": "SME Data successful",
    "data": {
        "transaction_ref": "202610194829106",
        "request_id": "REQ_SME_84920",
        "amount": 260.0,
        "phone": "08012345678",
        "plan": "1.0GB SME",
        "new_balance": 3742.0,
        "status": "success"
    }
}

Failed Response (400 Bad Request)

{
    "status": "failed",
    "code": 400,
    "message": "SME Data failed."
}