Click Airtime

Supported Networks

List available mobile networks, optionally filtered by country.

Supported Networks

List available mobile networks, optionally filtered by country. Use the returned id to query products or send airtime directly.

GET /v2/catalog/networks

Permission required: airtime.read

Query Parameters

ParameterTypeRequiredDescription
country_codestringNoISO 2-letter country code to filter by (e.g., GH, NG, KE)

Example Request

curl -X GET "https://api.clickairtime.com/v2/catalog/networks?country_code=GH" \
  -H "Authorization: Bearer ce_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
const response = await fetch(
  'https://api.clickairtime.com/v2/catalog/networks?country_code=GH',
  {
    headers: {
      'Authorization': 'Bearer ce_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    },
  }
);
const data = await response.json();
import requests

response = requests.get(
    'https://api.clickairtime.com/v2/catalog/networks',
    params={'country_code': 'GH'},
    headers={
        'Authorization': 'Bearer ce_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    }
)
data = response.json()
$ch = curl_init('https://api.clickairtime.com/v2/catalog/networks?country_code=GH');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ce_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = json_decode(curl_exec($ch));

Example Response

{
  "success": true,
  "data": [
    {
      "id": 22,
      "name": "MTN Ghana",
      "country": "Ghana",
      "country_code": "GH",
      "currency": "GHS",
      "logo_url": null,
      "product_count": 15,
      "supports_custom_airtime": true
    },
    {
      "id": 23,
      "name": "Vodafone Ghana",
      "country": "Ghana",
      "country_code": "GH",
      "currency": "GHS",
      "logo_url": null,
      "product_count": 8,
      "supports_custom_airtime": true
    },
    {
      "id": 24,
      "name": "AirtelTigo Ghana",
      "country": "Ghana",
      "country_code": "GH",
      "currency": "GHS",
      "logo_url": null,
      "product_count": 6,
      "supports_custom_airtime": false
    }
  ],
  "meta": {
    "request_id": "req_n1e2t3w4o5r6",
    "timestamp": "2024-01-15T10:30:00.000Z"
  }
}

Response Fields

FieldTypeDescription
idintegerNetwork ID (use in catalog lookup, product listing, or topup)
namestringNetwork operator name
countrystringCountry name
country_codestringISO 2-letter country code
currencystringLocal currency code
logo_urlstring | nullURL to the network's logo image
product_countintegerNumber of available fixed bundle products
supports_custom_airtimebooleanWhether custom amount airtime is supported

Omit the country_code parameter to retrieve all networks across all supported countries.