Routes and references
List countries
GET
https://api.smsedge.com/v1/references/countries/Returns all countries with their ID, ISO codes and phone code.
Use id as country_id in other endpoints. Countries are sorted by name. This endpoint does not need an API key.
The keys code_iso_aplha_2 and code_iso_aplha_3 are old misspelled copies of code_iso_alpha_2 and code_iso_alpha_3. They are kept for older integrations. Use the alpha keys.
This endpoint has no parameters besides your API key.
Responses
- 200All countries
curl -X GET "https://api.smsedge.com/v1/references/countries/" \
-H "X-API-KEY: YOUR_API_KEY"[
{
"success": true,
"data": [
{
"id": 225,
"code_iso_aplha_2": "GB",
"code_iso_alpha_2": "GB",
"code_iso_aplha_3": "GBR",
"code_iso_alpha_3": "GBR",
"code_phone": 44,
"name": "United Kingdom"
},
{
"id": 226,
"code_iso_aplha_2": "US",
"code_iso_alpha_2": "US",
"code_iso_aplha_3": "USA",
"code_iso_alpha_3": "USA",
"code_phone": 1,
"name": "United States"
}
],
"errors": [],
"response": {
"code": 200,
"description": "OK",
"date": "2026-11-16 13:58:20"
},
"api": {
"version": "v1",
"module": "references",
"function": "countries"
}
}
]All requests need your API key in the X-API-KEY header. See Authentication.