List route connections

GET

/routecon

Last modified:2026-10-09 00:42:15

OperationId:ListRoutecons

Returns route connections across every route, from route_con_config, sorted by route-destination-match-pattern and then route-connection-ordinal-index. Each row is one next hop: its route's 4 match fields, its ordinal index, host, destination user translation, percentage, and cost. Requires Super User, Reseller, or Super User Read Only scope.

Narrow it with route-destination-match-pattern, route-source-match-pattern, route-class, and route-match-server-hostname, all exact matches. Without a filter it lists every route connection on the platform, including those of route-profile routes. Page with start and limit, 100 rows by default. GET /routecon/count counts the same rows. To read one route's connections, use GET /routes/{route-id}/routecon.

The path is read-only, so any other method returns 405. Write a route connection through /routes/{route-id}/routecon.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200

application/json

The matching route connections. None returns [].

Bodyapplication/json

🟠400

🟠401

🟠403

🟠405Method Not Allowed

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/routecon?limit=100&start=undefined&route-destination-match-pattern=sip%3A1800*%40*&route-source-match-pattern=*&route-class=*&route-match-server-hostname=*' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Two route connections

The 2 next hops of one route.

[
    {
        "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": 0,
        "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": 0,
        "route-connection-integer-cost": 0
    }
]

Modified at 2026-10-09 00:42:15

Delete route connection

List domain route profiles