---
title: "List routing rules"
method: GET
path: "/api/governance/routing-rules"
tags: ["Governance"]
---

# List routing rules

`GET /api/governance/routing-rules`

Returns a list of all routing rules configured for intelligent request routing across providers.

## Query parameters

- `scope` string
- `scope_id` string

## Response `200`

Successful response

- ListRoutingRulesResponse — Response containing list of routing rules
  - `rules` RoutingRule[]
    - `id` string — Unique identifier for the routing rule
    - `name` string — Name of the routing rule
    - `description` string — Description of what the rule does
    - `enabled` boolean — Whether the rule is enabled and active
    - `cel_expression` string — CEL (Common Expression Language) expression for matching
    - `targets` object[] — Weighted routing targets; weights must sum to 1; target is selected probabilistically at request time
      - `provider` string, nullable — Target provider (omit or empty to use the incoming request provider)
      - `model` string, nullable — Target model (omit or empty to use the incoming request model)
      - `key_id` string, nullable — UUID of the API key to pin for this target (omit for load-balanced key selection)
      - `weight` number, double, required — Probability weight for this target (must be > 0; all target weights in a rule must sum to 1, e.g. 0.7 + 0.3 = 1.0)
    - `fallbacks` string[] — Fallback providers in format "provider/model"
    - `scope` 'global', required — Scope level for the rule
    - `scope_id` string, nullable — ID for the scope (empty for global scope)
    - `priority` integer — Priority for rule evaluation (lower number = higher priority)
    - `query` object, nullable — Visual rule tree structure from query builder
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `count` integer — Number of routing rules returned

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.net/getbifrost/apis/bifrost-api.md) · [All operations](https://skmtc.net/getbifrost/apis/bifrost-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbifrost/bifrost-api/versions/f8cab88f64ea/schema)