Routes and references

List countries

GEThttps://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.