List route connections

GET

/routes/{route-id}/routecon

Last modified:2026-10-30 21:27:41

OperationId:ReadRouteConnections

Returns the route connections, or next hops, of one route in route-connection-ordinal-index order. Requires Super User, Reseller, or Super User Read Only scope. To read connections across every route, use GET /routecon.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

The route's connections. A route with no connections, or a route-id that names no route, returns [].

Bodyapplication/json

🟠404

🟠400Bad Request

🟠401

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/routes/c2lwOjE4MDAqQCo/routecon?start=undefined&limit=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Two connections

A route that splits calls 60/40 over 2 carriers.

[
    {
        "route-destination-match-pattern": "sip:1800*@*",
        "route-source-match-pattern": "*",
        "route-class": "*",
        "route-match-server-hostname": "*",
        "route-connection-ordinal-index": 1,
        "route-connection-translation-destination-user": "[*]",
        "route-connection-translation-destination-host": "carrier1.example.com",
        "route-connection-integer-percentage": 60,
        "route-connection-integer-cost": 0
    },
    {
        "route-destination-match-pattern": "sip:1800*@*",
        "route-source-match-pattern": "*",
        "route-class": "*",
        "route-match-server-hostname": "*",
        "route-connection-ordinal-index": 2,
        "route-connection-translation-destination-user": "[*]",
        "route-connection-translation-destination-host": "carrier2.example.com",
        "route-connection-integer-percentage": 40,
        "route-connection-integer-cost": 0
    }
]

Modified at 2026-10-30 21:27:41

Count routes

Count route connections