List route connections

GET

/routes/{route-id}/routecon

Last modified:2026-10-09 01:07:12

OperationId:ReadRouteConnections

Returns the route connections of one route, from route_con_config, in route-connection-ordinal-index order. Each row is one next hop: its ordinal index, host, destination user translation, percentage, and cost, plus the route's 4 match fields. Requires Super User, Reseller, or Super User Read Only scope.

A route with no connections, or a route-id that names no route, returns []. Page with start and limit, 100 rows by default. /routes/{route-id}/routecon/count counts this route's connections only. 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. None 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-09 01:07:12

Count routes

Count route connections