eSMS AfricaeSMS Africa
API ReferenceSMS API

Coverage

GET /api/countries - Per-country networks, pricing, sender-ID policy and compliance rules.

Endpoint

GET https://sms.esmsafrica.io/api/countries

Returns all 54 African markets with their mobile networks, sender-ID policy, compliance rules and - where we route - the live price per segment, followed by any non-African destinations that are currently active and priced for sending. Use it to check whether a country is supported, what sender-ID registration it requires, and whether two-way SMS or OTP is available before you send.

This endpoint always lists the 54 African markets, plus only those non-African destinations that are live today (on-request countries are not listed). For worldwide coverage (all regions, available vs on_request status and USD prices) use the public GET /api/pricing/coverage endpoint described in Global Coverage.

For just the machine-usable route codes and prices, see Routes & countries and Pricing.

Authentication

Authorization: Bearer esms_live_your_api_key

Response

{
  "total": 54,
  "supported": 27,
  "countries": [
    {
      "country_code": "KE",
      "country_name": "Kenya",
      "networks": ["Safaricom", "Airtel", "Telkom"],
      "currency": "KES",
      "supported": true,
      "route_code": "ESMS_KE",
      "price_per_segment": 1.2,
      "price_currency": "KES",
      "sender_id_registration": true,
      "sender_id_free": false,
      "sender_id_fee_usd": null,
      "regulator": "CA",
      "promo_note": "Promotional SMS restricted 8pm-8am",
      "rules": ["Alphanumeric sender IDs must be pre-registered"],
      "otp_available": true,
      "two_way": true
    }
  ]
}
FieldDescription
supportedtrue when there is an active route for this country today.
route_code / price_per_segmentPublic route code and live per-segment price (only when supported).
networksMobile networks operating in the country.
sender_id_registrationWhether an alphanumeric sender ID must be pre-registered.
sender_id_freeWhether custom sender IDs are allowed without registration.
sender_id_fee_usdSender ID fee in USD covering all networks (in Kenya and Uganda, the bundle total), or null when the fee is confirmed during onboarding (see Sender IDs).
regulator / promo_note / rulesRegulator and country-specific delivery/compliance notes.
otp_availableWhether Verify/OTP can route here.
two_wayWhether inbound/two-way SMS is supported.

The top-level total is the number of rows returned (the 54 African markets plus any live non-African destinations, so it can be more than 54); supported is how many you can send to right now. Non-African rows also carry a region field and an empty networks list.

Example

curl https://sms.esmsafrica.io/api/countries \
  -H "Authorization: Bearer esms_live_your_api_key"

On this page