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
| Parameter | Type | Required | Description |
|---|---|---|---|
country_code | string | No | ISO 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
| Field | Type | Description |
|---|---|---|
id | integer | Network ID (use in catalog lookup, product listing, or topup) |
name | string | Network operator name |
country | string | Country name |
country_code | string | ISO 2-letter country code |
currency | string | Local currency code |
logo_url | string | null | URL to the network's logo image |
product_count | integer | Number of available fixed bundle products |
supports_custom_airtime | boolean | Whether custom amount airtime is supported |
Omit the country_code parameter to retrieve all networks across all supported countries.
