Introduction

Build your own data reselling business with the Rema Data API. Our secure, high-performance REST API allows you to programmatically purchase data bundles for MTN, Telecel, and AirtelTigo.

99.9% System Uptime

Engineered reliability for mission-critical businesses.

24/7 Developer Support

Direct access to our engineering team, day or night.

Free API Access

Get your API key instantly. No subscription fees or hidden charges.

Universal Coverage

Comprehensive support for all major networks across Ghana.

Developer Experience

RESTful endpoints, clean docs, and easy code examples.

Base URL: https://remadata.com/api

Authentication

Authenticate your requests by including your secret API key in the X-API-KEY header.

Keep your key secret! Never share your API key in client-side code (browsers, mobile apps). Only use it from your backend server.

Auth Header
curl -X GET https://remadata.com/api/wallet-balance \
  -H "X-API-KEY: rd_live_your_secret_key" \
  -H "Content-Type: application/json"

Get Available Bundles

GET/api/bundles

Fetch a complete list of data bundles available for purchase. This endpoint returns your specific API Pricing, which may be lower than public prices.

Query Parameters

networkOptional
stringFilter by 'mtn', 'telecel', or 'airteltigo'.
Request
# Get all bundles
curl -X GET https://remadata.com/api/bundles \
  -H "X-API-KEY: your_key"

# Filter by network
curl -X GET https://remadata.com/api/bundles?network=mtn \
  -H "X-API-KEY: your_key"
Response
{
  "status": "success",
  "data": [
    {
      "network": "mtn",
      "name": "1GB",
      "volume": "1.00GB",
      "volumeInMB": 1024,
      "price": 5.50, // Your special API Price
      "description": "Indomie bundle..."
    },
    {
      "network": "telecel",
      "name": "2GB",
      "price": 10.00,
      ...
    }
  ]
}

Check Real-Time Price

POST/api/get-cost-price

Verify the exact cost of a specific data volume before purchasing. This is useful for dynamic pricing displays in your own app.

Body Parameters

networkTypeRequired
stringProvider: 'mtn', 'telecel', 'airteltigo'
volumeInMBRequired
numberSize in numeric MB (e.g. 1024)
Request
{
  "networkType": "mtn",
  "volumeInMB": 1024
}
Response
{
  "status": "success",
  "volume": "1024MB",
  "network": "mtn",
  "api_price": "5.50",
  "currency": "GHS"
}

Purchase Data

POST/api/buy-data

Initiate a data purchase transaction. The amount will be deducted from your wallet instantly.

Body Parameters

refRequired
stringYour unique reference ID (e.g. ORDER_123)
phoneRequired
stringRecipient number (10 digits)
volumeInMBRequired
numberBundle size (e.g. 1024)
networkTypeRequired
string'mtn', 'telecel', 'airteltigo'
Node.js Example
const axios = require('axios');

await axios.post('https://remadata.com/api/buy-data', {
  ref: 'MY_ORDER_001',
  phone: '0551234567',
  volumeInMB: 1024,
  networkType: 'mtn'
}, {
  headers: { 'X-API-KEY': 'your_key' }
});
Success Response
{
  "status": "success",
  "message": "Order processed successfully",
  "data": {
    "orderId": "ORD_...",
    "reference": "MY_ORDER_001",
    "status": "completed",
    "amount": 5.50
  }
}

Wallet Balance

GET/api/wallet-balance

Check your current account balance.

Request
curl -H "X-API-KEY: key" https://remadata.com/api/wallet-balance
Response
{
  "status": "success",
  "data": {
    "balance": "150.00",
    "currency": "GHS"
  }
}

Order History

GET/api/orders

1. Check Order Status

Quickly check the current status of an order using its reference number.

refRequired
stringThe order reference (e.g. ORD_...)
Check Status
curl -X GET https://remadata.com/api/order-status/ORD_123456 \
  -H "X-API-KEY: your_api_key"

2. Get All Orders

Retrieve a paginated list of all your orders. By default, it returns the latest 15 orders.

pageOptional
numberPage number (default: 1).
per_pageOptional
numberItems per page (default: 15).
Get All Orders
curl -H "X-API-KEY: key" https://remadata.com/api/orders

3. Get Order by ID

Fetch details of a single specific order using its unique ID.

idRequired
stringThe unique MongoDB ID of the order.
Get Order by ID
curl -H "X-API-KEY: key" "https://remadata.com/api/orders?id=65b123..."

4. Get by Reference

Find an order using your own custom reference number provided during purchase.

ref_numberRequired
stringPartial or exact match of your reference.
Get by Reference
curl -H "X-API-KEY: key" "https://remadata.com/api/orders?ref_number=MY_REF_001"

5. Advanced Filtering

Combine multiple filters to find specific subsets of orders.

statusOptional
string'completed', 'failed', 'pending'
networkOptional
string'mtn', 'telecel', 'airteltigo'
start_dateOptional
stringYYYY-MM-DD
end_dateOptional
stringYYYY-MM-DD
Filter by Status & Network
curl -H "X-API-KEY: key" "https://remadata.com/api/orders?status=completed&network=mtn"
Filter by Date Range
curl -H "X-API-KEY: key" "https://remadata.com/api/orders?start_date=2025-01-01&end_date=2025-01-31"