Y3DATA DEVELOPER REST API v1

Build Automated Digital Services Directly Into Your Platform

Connect your website, mobile app, or enterprise platform to Y3Data's high-speed telecom and utility gateway. Instant provisioning, dynamic pricing, zero double-charges, and real-time webhook notifications.

Open Developer Dashboard View API Pricing Explore API Docs
JSON REST Interface Bearer API Key Auth Idempotent Transactions HMAC-SHA256 Webhooks
API Capabilities

Production-Ready Digital Services

Every service endpoint is backed by automated failover routing, real-time balance checks, and atomic state updates.

Mobile Data Bundles

Automated provisioning across MTN (SME, Gifting, Corporate), Airtel, Glo, and 9mobile. Instant delivery with direct plan catalog inspection.

POST /api/v1/data/purchase

Airtime VTU

Real-time top-ups from ₦50 to ₦50,000 with volume discount pricing calculated server-side based on your active pricing tier.

POST /api/v1/airtime/purchase

Electricity DisCos

Prepaid & postpaid meter validation and instant token generation across IKEDC, EKEDC, AEDC, IBEDC, KEDCO, PHED, and more.

POST /api/v1/electricity/purchase

Cable TV Subscriptions

SmartCard & IUC verification with automated package activation across DStv, GOtv, StarTimes, and Showmax.

POST /api/v1/cable/subscribe

Educational Exam PINs

Generate electronic scratch card tokens for WAEC, NECO, NABTEB, and JAMB UTME profiling in single or batch quantities.

POST /api/v1/exams/purchase

Balance & Status Query

Real-time wallet balance polling and idempotent transaction inquiry using either Y3Data reference or your client request_id.

GET /api/v1/account/balance
Transparent API Rates

Live Developer API Pricing & Catalog

Standard production rates served directly from our core backend pricing catalog. Volume enterprise tiers and custom discounts can be assigned to your developer account.

Network Product / Plan ID Description Type Validity API Rate
MTN mtn_500mb_sme MTN 500 MB SME 30 Days ₦241.50
MTN mtn_1gb_sme MTN 1GB SME 30 Days ₦400.00
MTN mtn_2gb_sme MTN 2GB SME 30 Days ₦810.00
MTN mtn_3gb_sme MTN 3.0GB SME SME 30 Days ₦1,048.95
MTN mtn_500mb_cg MTN 500 MB Corporate Gifting 30 Days ₦245.00
MTN mtn_1gb_cg MTN 1GB Corporate Gifting 30 Days ₦460.00
MTN mtn_2gb_cg MTN 2GB Corporate Gifting 30 Days ₦838.95
MTN mtn_3gb_cg MTN 3 GB Corporate Gifting 30 Days ₦1,365.00
MTN mtn_5gb_cg MTN 5GB Corporate Gifting 30 Days ₦1,785.00
MTN mtn_11 MTN 1.5GB Gifting 30 Days ₦997.50
MTN mtn_12 MTN 2.5GB Gifting 30 Days ₦1,470.00
MTN mtn_13 MTN 75MB Gifting 30 Days ₦101.85
MTN mtn_14 MTN 5GB Gifting 30 Days ₦1,155.00
9MOBILE 9mobile_15 9mobile 1.0GB Gifting Gifting 30 Days ₦472.50
9MOBILE 9mobile_16 9mobile 2.0GB Gifting Gifting 30 Days ₦945.00
9MOBILE 9mobile_17 9mobile 5.0GB Corporate Corporate Gifting 30 Days ₦2,100.00
9MOBILE 9mobile_18 9mobile 500MB Corporate Corporate Gifting 30 Days ₦189.00
MTN mtn_19 MTN 3.2GB 2-Day Plan Gifting 30 Days ₦1,018.50
9MOBILE 9mobile_20 9mobile 1.0GB SME SME 30 Days ₦231.00
9MOBILE 9mobile_21 9mobile 2.0GB SME SME 30 Days ₦472.50
9MOBILE 9mobile_22 9mobile 5.0GB SME SME 30 Days ₦1,155.00
9MOBILE 9mobile_23 9mobile 1.5GB Data Sharing Direct 30 Days ₦367.50
9MOBILE 9mobile_24 9mobile 2.0GB Data Sharing Direct 30 Days ₦546.00
AIRTEL airtel_1gb_cg AIRTEL 1GB 7days 800 Corporate Gifting 30 Days ₦823.20
AIRTEL airtel_2gb_cg AIRTEL 2GB Monthly Plan 1500 Corporate Gifting 30 Days ₦1,543.50
AIRTEL airtel_3gb_cg AIRTEL 3GB Monthly Plan 2000 Corporate Gifting 30 Days ₦2,058.00
AIRTEL airtel_28 AIRTEL 8GB Monthly Plan 3000 Corporate Gifting 30 Days ₦3,087.00
AIRTEL airtel_29 AIRTEL 10GB Monthly Plan 4000 Corporate Gifting 30 Days ₦4,116.00
GLO glo_30 GLO 1GB Direct 30 Days ₦378.00
GLO glo_31 GLO 1GB Direct 30 Days ₦388.50
GLO glo_32 GLO 3GB Direct 30 Days ₦1,123.50
GLO glo_33 GLO 2GB Gifting 30 Days ₦556.50
GLO glo_34 GLO 200 MB Corporate Gifting 30 Days ₦105.00
GLO glo_500mb_cg GLO 500 MB Corporate Gifting 30 Days ₦236.25
GLO glo_1gb_cg GLO 1 GB Corporate Gifting 30 Days ₦430.50
GLO glo_2gb_cg GLO 2.0 GB Corporate Gifting 30 Days ₦882.00
GLO glo_38 GLO 3.0 GB Corporate Gifting 30 Days ₦1,323.00
GLO glo_39 GLO 5GB Corporate Gifting 30 Days ₦2,205.00
AIRTEL airtel_40 AIRTEL 1.5GB Direct 30 Days ₦546.00
GLO glo_41 GLO 10GB Corporate Gifting 30 Days ₦4,410.00
AIRTEL airtel_42 AIRTEL 10Min Direct 30 Days ₦115.50
AIRTEL airtel_43 AIRTEL 600MB ) Direct 30 Days ₦220.50
AIRTEL airtel_44 AIRTEL 1GB Social plan Direct 30 Days ₦308.70
AIRTEL airtel_45 AIRTEL 7GB Direct 30 Days ₦2,058.00
AIRTEL airtel_46 AIRTEL 10GB ) Direct 30 Days ₦3,087.00
AIRTEL airtel_47 AIRTEL 30Min Direct 30 Days ₦336.00
AIRTEL airtel_500mb_cg AIRTEL 500MB Corporate Gifting 30 Days ₦514.50
AIRTEL airtel_49 AIRTEL 150Mins Direct 30 Days ₦1,627.50
AIRTEL airtel_50 AIRTEL 1.5GB Monthly Direct 30 Days ₦997.50
AIRTEL airtel_51 AIRTEL 3GB Monthly Direct 30 Days ₦1,491.00
AIRTEL airtel_52 AIRTEL 7GB Monthly Direct 30 Days ₦2,499.00
AIRTEL airtel_53 AIRTEL 10GB Monthly Direct 30 Days ₦3,517.50
MTN mtn_54 MTN 1GB Gifting 30 Days ₦252.00
MTN mtn_55 MTN 2.5GB Corporate Gifting 30 Days ₦840.00
AIRTEL airtel_56 AIRTEL 5GB Awoof Bumper Direct 30 Days ₦1,732.50
AIRTEL airtel_57 AIRTEL 1GB Data Sharing Direct 30 Days ₦819.00
AIRTEL airtel_58 AIRTEL 2GB Data Sharing Direct 30 Days ₦1,522.50
AIRTEL airtel_59 AIRTEL 5GB Data Sharing Direct 30 Days ₦2,782.50
AIRTEL airtel_60 AIRTEL 2GB Social All-in-One Direct 30 Days ₦609.00
GLO glo_61 GLO 1GB Data Sharing Direct 30 Days ₦441.00
MTN mtn_62 MTN 10GB Corporate Gifting 30 Days ₦3,465.00
AIRTEL airtel_65 AIRTEL 4.00GB Corporate Gifting 30 Days ₦1,029.00
MTN mtn_66 MTN 2GB Gifting 30 Days ₦498.75
MTN mtn_67 MTN 3GB Gifting 30 Days ₦714.00
MTN mtn_68 MTN 1GB ) Corporate Gifting 30 Days ₦520.00
MTN mtn_69 MTN 2GB ) Corporate Gifting 30 Days ₦525.00
MTN mtn_70 MTN 3GB ) Corporate Gifting 30 Days ₦819.00
AIRTEL airtel_72 AIRTEL 1.5GB ) Direct 30 Days ₦441.00
AIRTEL airtel_73 AIRTEL 2GB ) Direct 30 Days ₦640.50
AIRTEL airtel_74 AIRTEL 150MB ) Direct 30 Days ₦57.75
AIRTEL airtel_75 AIRTEL 300MB ) Direct 30 Days ₦115.50
AIRTEL airtel_77 AIRTEL 20Min Direct 30 Days ₦231.00
GLO glo_78 GLO 3.2GB Gifting 30 Days ₦1,155.00
MTN mtn_79 MTN 1.5GB 2-Day Plan Gifting 30 Days ₦611.10
MTN mtn_80 MTN 2GB 2-Day Plan Gifting 30 Days ₦764.40
GLO glo_81 GLO 3 GB Direct 30 Days ₦1,155.00
GLO glo_82 GLO 5GB Direct 30 Days ₦1,837.50
GLO glo_83 GLO 5GB Direct 30 Days ₦1,942.50
MTN mtn_84 MTN 12 hrs YouTube Gifting 30 Days ₦611.10
MTN mtn_85 MTN 4GB Gifting 30 Days ₦1,222.20
MTN mtn_86 MTN 5.5GB Gifting 30 Days ₦1,527.75
MTN mtn_87 MTN 1GB Gifting 30 Days ₦305.55
MTN mtn_88 MTN 2GBtiktok Gifting 30 Days ₦407.40
MTN mtn_89 MTN 6GB Gifting 30 Days ₦2,546.25
MTN mtn_90 MTN 11GB Gifting 30 Days ₦3,564.75
MTN mtn_91 MTN 20GB Gifting 30 Days ₦7,796.25
MTN mtn_92 MTN 90GB Gifting 30 Days ₦25,462.50
MTN mtn_140 MTN 10GB SME SME 30 Days ₦3,097.50
MTN mtn_141 MTN 10GB Corporate Gifting 30 Days ₦3,465.00
9MOBILE 9mobile_206 9mobile 500MB Corporate Gifting Corporate Gifting 30 Days ₦189.00
9MOBILE 9mobile_207 9mobile 1.0GB Corporate Gifting Corporate Gifting 30 Days ₦472.50
9MOBILE 9mobile_208 9mobile 2.0GB Corporate Gifting Corporate Gifting 30 Days ₦945.00
9MOBILE 9mobile_209 9mobile 5.0GB Corporate Gifting Corporate Gifting 30 Days ₦2,362.50
GLO glo_334 GLO 200MB Corporate Gifting 30 Days ₦105.00
Developer Workflow

From Sign Up to First Request in Minutes

01

Create Account

Register or sign in to your Y3Data account and activate Developer API access from the dashboard.

02

Generate API Key

Create your production key in the API Keys tab. Save it safely — keys are only shown in plain text once.

03

Fund Your Wallet

Deposit funds into your Y3Data wallet using instant virtual bank transfers or online payment options.

04

Dispatch Requests

Send requests with unique request_id headers and receive instant JSON confirmations or webhooks.

Quick Integration

Clean, Predictable REST Contracts

Every request requires standard Bearer token authorization. Idempotency is enforced through client-provided request_id strings, ensuring safe network retries without accidental duplicate debits.

  • Server-authoritative pricing based on assigned plan tier
  • Pre-check atomic wallet reservation before external dispatch
  • Automatic wallet refund on upstream provider failure
Full API Specification
cURL • Data Purchase
curl -X POST "https://y3data.com/api/v1/data/purchase" \
  -H "Authorization: Bearer y3_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "MTN",
    "plan_id": "mtn_1gb_sme",
    "phone": "08012345678",
    "request_id": "ORDER-98234-XYZ"
  }'
200 OK Response
{
  "status": "success",
  "transaction_id": "Y3API-ABCDEF12345",
  "request_id": "ORDER-98234-XYZ",
  "service": "data",
  "amount": 404.25,
  "balance_after": 14595.75
}

Ready to Automate Your Digital Services?

Sign in to your Y3Data account to activate developer access and issue your production API keys immediately.

Go to Developer Dashboard Contact Developer Support