Get Routing Rule
Read the full configuration of one routing rule, including its conditions array. Same shape as a single entry from /routing-rules.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.rule_uuid string (uuid) Req
The routing rule's
uuid from the list. Resolved under this endpoint only.Deprecated: the legacy integer id is still accepted in the path until the sunset, answered with Deprecation and Sunset headers. Use the uuid.
Response (200 OK)
Same shape as a single entry from /routing-rules list.
Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.
Errors
400 Bad Request
An integer rule id after the sunset (
integer_id_unsupported).401 Unauthorized
Missing auth.
404 Not Found
Endpoint or rule doesn't exist (or doesn't belong to the calling account). A rule of another endpoint reads like an unknown one (
Routing rule not found).Request
curl "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/routing-rules/019b8b02-732f-7d67-b36a-271ec6e8d5fa" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
rule = client.routing_rules.get("019bb1e4-e785-77d2-9966-c3cff31d0a0e", "019b8b02-732f-7d67-b36a-271ec6e8d5fa")
print(rule["name"], rule["target_agent_id"])
Response — 200 OK
{
"uuid": "019b8b02-732f-7d67-b36a-271ec6e8d5fa",
"endpoint_uuid": "019bb1e4-e785-77d2-9966-c3cff31d0a0e",
"name": "api-route",
"priority": 10,
"target_agent_id": "api-agent-prod",
"enabled": true,
"fallback": false,
"conditions": [
{"rule_uuid": "019b8b02-732f-7d67-b36a-271ec6e8d5fa", "condition_type": "path", "pattern": "/api/*", "negate": false}
],
"created_at": "2026-04-29T12:00:00Z",
"updated_at": "2026-04-29T12:00:00Z"
}
Was this helpful?