Routes and references

List routes

GEThttps://api.smsedge.com/v1/routes/getall/

Returns the routes your account can send through, with your price per SMS part for each country.

Each item is one route in one country. A route that serves many countries appears once per country. Use id as preferred_route_id when you send, and as route_id in reports.

The list comes from your account's routing groups. With transactional=1 it shows the routes for transactional messages. Results are sorted by country name. price is in your account currency.

Query params

  • country_idintegeroptional

    Returns only routes for this country. See List countries.

  • transactionalintegeroptional

    1 returns the routes for transactional messages.

    Default: 0Values: 0, 1

Responses

  • 200Available routes
  • 401The API key is missing, wrong or the account is blocked
  • 404The country does not exist, or no route is available. The other message is "No available routes found for non-transactional messages to United Kingdom".
curl -X GET "https://api.smsedge.com/v1/routes/getall/?country_id=225&transactional=0" \
  -H "X-API-KEY: YOUR_API_KEY"
[
  {
    "success": true,
    "data": [
      {
        "id": "108",
        "name": "Route 137",
        "country_id": "225",
        "country_name": "United Kingdom",
        "price": 0.046332
      },
      {
        "id": "679",
        "name": "Route 250",
        "country_id": "225",
        "country_name": "United Kingdom",
        "price": 0.048906
      }
    ],
    "errors": [],
    "response": {
      "code": 200,
      "description": "OK",
      "date": "2026-11-16 13:58:20"
    },
    "api": {
      "version": "v1",
      "module": "routes",
      "function": "getall"
    },
    "user": {
      "id": 736
    }
  }
]

All requests need your API key in the X-API-KEY header. See Authentication.