API ReferenceSMS API
Routes & countries
GET /api/routes - List supported SMS destinations and their route codes.
Endpoint
GET https://sms.esmsafrica.io/api/routesReturns every active destination you can send to, each with its public route
code (ESMS_<CC>). Use a code as the route field on Send SMS
to force a destination instead of auto-detecting from the number.
Authentication
Authorization: Bearer esms_live_your_api_keyResponse
[
{
"code": "ESMS_KE",
"name": "Kenya",
"country_code": "KE",
"country_name": "Kenya",
"currency": "KES",
"price_per_segment": 1.2,
"sender_id_default": "eSMSAfrica",
"is_active": true
}
]| Field | Description |
|---|---|
code | Public route code to pass as route when sending. |
country_code | ISO-2 country. |
currency / price_per_segment | Route currency and per-segment price (see Pricing). |
sender_id_default | Sender ID used when you do not pass one. |
Fetch a single route with GET /api/routes/{code}, e.g. /api/routes/ESMS_KE.
Example
curl https://sms.esmsafrica.io/api/routes \
-H "Authorization: Bearer esms_live_your_api_key"