API Documentation — AlphaDataHub

AlphaDataHub REST API

Integrate data bundle purchases directly into your app, website, or system. Simple REST API with JSON responses.

Base URL: https://star1.alpha-datahub.shop/api/v1

✓ REST API JSON HTTPS Only v1 Stable

📖 Introduction

The AlphaDataHub API allows developers to programmatically purchase data bundles across MTN, Telecel, AirtelTigo (iShare & BigTime) networks in Ghana. Build reseller apps, automate bulk purchases, or integrate into existing platforms.

🚀 Quick Start

1. Register at alpha-datahub.shop/register
2. Fund your wallet from your dashboard
3. Generate an API key from Profile → API Keys
4. Make your first request using the examples below

cURL — Quick Test

# Test your API key
curl https://star1.alpha-datahub.shop/api/v1/balance \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

🔑 Authentication

All API requests must include your API key in the request header. Keep your API key secret — never expose it in frontend code.

Required Header

Header	Value	Description
x-api-key	string	Your API key from dashboard
Accept	string	Must be `application/json`
Content-Type	string	Required for POST: `application/json`

Example Headers

x-api-key: adhk_live_xxxxxxxxxxxxxxxxxxxxxxxx
Accept: application/json
Content-Type: application/json

GET Check Balance

Returns your current wallet balances.

GET /api/v1/balance

cURL

curl https://star1.alpha-datahub.shop/api/v1/balance \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

200 OK

Response

{
  "success": true,
  "balance": {
    "main": 150.00,
    "referral": 12.50,
    "agent": 30.00
  }
}

GET Get Networks

Returns all active networks available for data purchases.

GET /api/v1/networks

cURL

curl https://star1.alpha-datahub.shop/api/v1/networks \
  -H "x-api-key: YOUR_API_KEY"

200 OK

Response

{
  "success": true,
  "networks": [
    {
      "id": 1,
      "name": "MTN",
      "slug": "mtn",
      "color": "#FFC300",
      "delivery": "5-60 minutes",
      "bundles_count": 10
    },
    {
      "id": 2,
      "name": "Telecel",
      "slug": "telecel",
      "color": "#E40032",
      "delivery": "5-60 minutes",
      "bundles_count": 8
    }
  ]
}

GET Get Bundles

Returns all available bundles for a specific network. Prices shown are based on your account's price group.

GET /api/v1/networks/{network_id}/bundles

Path Parameters

Parameter	Type	Required	Description
network_id	integer	Required	Network ID from /networks endpoint

cURL

curl https://star1.alpha-datahub.shop/api/v1/networks/1/bundles \
  -H "x-api-key: YOUR_API_KEY"

200 OK

Response

{
  "success": true,
  "network": "MTN",
  "bundles": [
    {
      "id": 1,
      "size": "1GB",
      "name": "MTN 1GB Bundle",
      "price": 5.00,
      "badge": "Non-Expiry",
      "is_active": true
    }
  ]
}

POST Place Order

Purchase a data bundle for a phone number. The amount is deducted from your main wallet balance.

POST /api/v1/orders

Request Body

Parameter	Type	Required	Description
bundle_id	integer	Required	Bundle ID from /bundles endpoint
phone_number	string	Required	Ghana phone number (0XXXXXXXXX or 233XXXXXXXXX)
reference	string	Optional	Your custom order reference for tracking

cURL

curl https://star1.alpha-datahub.shop/api/v1/orders \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "bundle_id": 1,
    "phone_number": "0244123456",
    "reference": "MY-REF-001"
  }'

200 OK — Success

Response — Success

{
  "success": true,
  "message": "1GB data sent to 0244123456 successfully",
  "order": {
    "order_number": "ORD-XXXXXXXXXXX",
    "bundle": "MTN 1GB",
    "phone_number": "0244123456",
    "amount_paid": 5.00,
    "status": "successful",
    "reference": "MY-REF-001",
    "created_at": "2026-05-17T12:00:00Z"
  },
  "wallet_balance": 145.00
}

400 — Insufficient Balance

Response — Error

{
  "success": false,
  "message": "Insufficient wallet balance",
  "balance": 2.50,
  "required": 5.00
}

GET Order Status

Check the status of a specific order using the order number.

GET /api/v1/orders/{order_number}

cURL

curl https://star1.alpha-datahub.shop/api/v1/orders/ORD-XXXXXXXXXXX \
  -H "x-api-key: YOUR_API_KEY"

200 OK

Response

{
  "success": true,
  "order": {
    "order_number": "ORD-XXXXXXXXXXX",
    "bundle": "MTN 1GB",
    "network": "MTN",
    "phone_number": "0244123456",
    "amount_paid": 5.00,
    "status": "successful",
    "created_at": "2026-05-17T12:00:00Z"
  }
}

GET Order History

Returns a paginated list of your recent orders.

GET /api/v1/orders?page=1&status=successful

Query Parameters

Parameter	Type	Required	Description
page	integer	Optional	Page number (default: 1)
status	string	Optional	Filter: pending, successful, failed
per_page	integer	Optional	Items per page (max: 50, default: 20)

⚠️ Error Codes

All errors return a JSON object with success: false and a message field.

Code	Meaning	Description
200	OK	Request succeeded
400	Bad Request	Invalid parameters or insufficient balance
401	Unauthorized	Missing or invalid API key
404	Not Found	Resource not found
422	Validation	Request validation failed
429	Rate Limited	Too many requests
500	Server Error	Internal server error — contact support

🚦 Rate Limits

API requests are rate limited to prevent abuse.

Endpoint	Limit	Window
All endpoints	60 requests	Per minute
POST /orders	10 orders	Per minute
GET /balance	30 requests	Per minute

🪝 Webhooks Coming Soon

Webhooks will notify your server when order status changes. Set your webhook URL in your dashboard settings.

Webhooks will send a POST request to your URL with order data when:
• Order status changes to successful
• Order status changes to failed
• Wallet is funded or debited

Ready to start building?

Create an account and get your API key in minutes.

🚀 Get Started Free →