Retrieve a route

Fetch a single routing rule by its id.

GET /v1/routes/{id} Preview

https://api.routeur.ai

Path parameters

id string required

Route id, e.g. route_01J....

Returns

The matching Route object, or 404 not_found.

← Create route Replace route →

curl https://api.routeur.ai/v1/routes/route_01J... \
  -H "Authorization: Bearer $ROUTEUR_KEY"

const res = await fetch(
  `https://api.routeur.ai/v1/routes/${id}`,
  { headers: { Authorization: `Bearer ${process.env.ROUTEUR_KEY}` } }
);
const route = await res.json();

r = requests.get(
    f"https://api.routeur.ai/v1/routes/{route_id}",
    headers={"Authorization": f"Bearer {os.environ['ROUTEUR_KEY']}"},
)
route = r.json()

200 application/json

Response

{
  "id":          "route_01J...",
  "name":        "premium_demo",
  "priority":    100,
  "enabled":     true,
  "action_kind": "pin",
  "match":  { "requested_model": "demo-premium" },
  "action": { "provider": "openai", "model": "gpt-4o" }
}