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 500MB SME SME 30 Days ₦140.00
MTN mtn_1gb_sme 1.0GB SME SME 30 Days ₦270.00
MTN mtn_2gb_sme 2.0GB SME SME 30 Days ₦540.00
MTN mtn_3gb_sme 3.0GB SME SME 30 Days ₦810.00
MTN mtn_5gb_sme 5.0GB SME SME 30 Days ₦1,350.00
MTN mtn_10gb_sme 10.0GB SME SME 30 Days ₦2,700.00
MTN mtn_1gb_cg 1.0GB Corporate Gifting Corporate Gifting 30 Days ₦290.00
MTN mtn_2gb_cg 2.0GB Corporate Gifting Corporate Gifting 30 Days ₦580.00
MTN mtn_5gb_cg 5.0GB Corporate Gifting Corporate Gifting 30 Days ₦1,450.00
AIRTEL airtel_500mb_cg 500MB Corporate Gifting Corporate Gifting 30 Days ₦150.00
AIRTEL airtel_1gb_cg 1.0GB Corporate Gifting Corporate Gifting 30 Days ₦295.00
AIRTEL airtel_2gb_cg 2.0GB Corporate Gifting Corporate Gifting 30 Days ₦590.00
AIRTEL airtel_5gb_cg 5.0GB Corporate Gifting Corporate Gifting 30 Days ₦1,475.00
AIRTEL airtel_10gb_cg 10.0GB Corporate Gifting Corporate Gifting 30 Days ₦2,950.00
GLO glo_500mb_cg 500MB Corporate Gifting Corporate Gifting 30 Days ₦145.00
GLO glo_1gb_cg 1.0GB Corporate Gifting Corporate Gifting 30 Days ₦275.00
GLO glo_2gb_cg 2.0GB Corporate Gifting Corporate Gifting 30 Days ₦550.00
GLO glo_5gb_cg 5.0GB Corporate Gifting Corporate Gifting 30 Days ₦1,375.00
9MOBILE 9mobile_500mb_cg 500MB Corporate Gifting Corporate Gifting 30 Days ₦140.00
9MOBILE 9mobile_1gb_cg 1.0GB Corporate Gifting Corporate Gifting 30 Days ₦220.00
9MOBILE 9mobile_2gb_cg 2.0GB Corporate Gifting Corporate Gifting 30 Days ₦440.00
9MOBILE 9mobile_5gb_cg 5.0GB Corporate Gifting Corporate Gifting 30 Days ₦1,100.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": 270.00,
  "balance_after": 14730.00
}

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