Developer API

Build data and bill payments into your own app

The same endpoints that power the Gideex dashboard are available to you directly. Generate a key, fund a wallet, and start selling data, airtime, electricity, and cable subscriptions from your own product.

Create a free account Get your API key

Key-based auth

Generate and revoke keys from Settings → API Key, no separate approval process.

Same-day delivery

Purchases post to the recipient in seconds, same as the dashboard flow.

Your wallet, your limits

API purchases draw from the same wallet balance you fund manually — no separate credit line.

Quickstart

Three steps from zero to your first API call.

Create an account and fund your wallet

API purchases are billed against the same wallet as the dashboard. Fund it once via bank transfer or card before your first call.

Generate an API key

Go to Dashboard → Profile → API Key and generate one. Store it somewhere safe — regenerating a key invalidates the old one immediately.

Make your first request

Every request needs a Bearer token in the Authorization header. Here's a data purchase using your API key:

curl

curl -X POST https://gideex.com/api/services/purchase-data/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "plan": 12,
    "mobile_number": "08145653211",
    "network": 1
  }'

Example response

{
  "success": true,
  "message": "Data purchase successful",
  "data": {
    "transaction_id": "DATA20260825...",
    "status": "successful",
    "date": "2026-08-25T10:32:00Z"
  }
}

Endpoint reference

The core endpoints most integrations use. Full field-level docs are linked from your dashboard once you have a key.

Method	Endpoint	Description
GET	/api/services/networks/	List supported mobile networks
GET	/api/services/data-plans/{network_id}/	List data plans for a network
POST	/api/services/purchase-data/	Buy a data bundle
POST	/api/services/purchase-airtime/	Recharge airtime
POST	/api/services/validate-meter/	Validate an electricity meter number
POST	/api/services/purchase-electricity/	Pay an electricity bill
POST	/api/services/validate-smartcard/	Validate a cable smartcard/IUC number
POST	/api/services/purchase-cable/	Renew a cable TV subscription
GET	/api/auth/wallet/	Check your wallet balance
GET	/api/transactions/mine/	List your transaction history

Need a webhook for transaction status updates instead of polling? Reach out to support with your use case — webhook delivery is available on request for verified integrations.

Ready to build?

Create a Gideex account, generate a key, and you can be making your first live purchase in under five minutes.

Get started free