SMS API

Country Coverage

Which destinations we reach, and how each one is carried. You never choose a route — we pick it from the destination number and fall back automatically if the first one is unavailable. Use this endpoint to check a destination is supported, and whether a sender ID will work there, before you send.

GET/api/v1/sms/countries

REQUEST

# every destination
curl https://api.sendcomms.com/api/v1/sms/countries

# only the local African networks
curl "https://api.sendcomms.com/api/v1/sms/countries?route=africa_local"

# search by country name or dialing code
curl "https://api.sendcomms.com/api/v1/sms/countries?q=kenya"
curl "https://api.sendcomms.com/api/v1/sms/countries?q=233"

Query Parameters

Parameter	Description
route	Filter to one route: `africa_local`, `africa_regional` or `global`.
q	Match on country name or dialing code.

RESPONSE200 OK

{
  "success": true,
  "data": {
    "countries": [
      {
        "country": "Ghana",
        "dialing_code": "+233",
        "route": "africa_local",
        "supported": true,
        "sender_id_supported": true
      },
      {
        "country": "Kenya",
        "dialing_code": "+254",
        "route": "africa_local",
        "supported": true,
        "sender_id_supported": true
      },
      {
        "country": "United Kingdom",
        "dialing_code": "+44",
        "route": "global",
        "supported": true,
        "sender_id_supported": false
      }
    ],
    "total": 176,
    "routes": { "…": "…" }
  }
}

Routes

Route	What it means	Sender IDs
africa_local	Carried on a local African network. Best rates and best deliverability in these markets.	Registered sender IDs supported
africa_regional	African countries not on a local network. Carried on our regional African route.	Registered sender IDs supported
global	Everywhere else — 180+ countries on our global route.	Alphanumeric sender IDs vary by country

Notes

Routes can change. We move destinations between routes as coverage and quality change. Your code should read this endpoint rather than hard-coding a list.
Sender IDs are per-market. A name approved for one market is not automatically usable in another — see Sender IDs.
Supported does not mean unrestricted. Individual countries apply their own content rules — Ghana, for example, does not permit promotional SMS on Sundays.

← Sender IDs Pricing →