Documentation

REST API · JSON · Bearer auth · Base URL https://api.ghdatastores.com

Create an order

curl -X POST https://api.ghdatastores.com/v1/orders \
  -H "Authorization: Bearer ds_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "mtn",
    "bundle": "mtn-5",
    "phone": "0245550198",
    "reference": "your-unique-id"
  }'

Response

{
  "id": "DS-7F3K2Q",
  "status": "processing",
  "amount": 21.83,
  "network": "mtn",
  "phone": "0245550198",
  "created_at": "2026-09-03T08:42:11Z"
}

Endpoints

POST	/v1/orders	Create a data, airtime or checker order
GET	/v1/orders/:id	Fetch order status
GET	/v1/orders	List orders (paginated)
GET	/v1/pricing	Current bundle catalogue & prices
GET	/v1/wallet	Wallet balance
POST	/v1/webhooks	Register a webhook endpoint

Order statuses

pending
Received, awaiting wallet debit
processing
Sent to the network
delivered
Confirmed on the recipient's line
failed
Network rejected — wallet refunded