List routes

Return every routing rule belonging to the authenticated organisation, sorted by priority descending.

GET /v1/routes Preview

https://api.routeur.ai

Query parameters

enabled boolean optional

Restrict the result to only enabled (or only disabled) rules.

limit integer optional · default 50, max 200

Maximum number of rules to return.

Returns

An object with data (array of Route objects) and has_more (boolean).

← The Route object Create route →

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

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

import os, requests

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

200 application/json

Response

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