> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Routing Preferences

> List every Routing Studio preference visible to the caller.

Returns every preference authored by the caller plus every team-scoped preference in the active organization. Each preference bundles a set of keyword rules, few-shot examples, and per-mode confidence-floor overrides that bias Theo's routing engine for the caller's domain.

Hidden per-key preferences (the rows backing the per-key routing-rules surface) are excluded from this listing — manage those via [`/api/v1/keys/{id}/routing-rules`](/api-reference/routing-preferences/key-routing-rules) instead.

## Authentication

Requires a Bearer token with the `billing` API key scope. See [Authentication](/api-reference/authentication).

## Request Examples

<CodeGroup>
  ```bash curl theme={null}
  curl https://www.hitheo.ai/api/v1/routing-preferences \
    -H "Authorization: Bearer $THEO_API_KEY"
  ```

  ```typescript SDK theme={null}
  const prefs = await theo.routingPreferences.list();
  ```
</CodeGroup>

## Response

<ResponseField name="routing_preferences" type="object[]">
  Array of preference objects. Each preference includes `id`, `name`, `description`, `user_id`, `org_id`, `enabled`, `is_default`, `rules`, `examples`, and `confidence_floor_overrides`.
</ResponseField>

### Example Response

```json theme={null}
{
  "routing_preferences": [
    {
      "id": "1f4f2c1a-22ce-4b07-9c0b-9c4f4b9b1d2e",
      "name": "ContractIQ Legal",
      "description": "Contract terms get the analytical engine.",
      "user_id": "user_abc",
      "org_id": null,
      "enabled": true,
      "is_default": false,
      "rules": [
        {
          "id": "r_a4b8c01x9y",
          "pattern": "\\b(clause|provision|indemnity|warranty)\\b",
          "target_mode": "think",
          "confidence": 0.92,
          "description": "Contract terms get the analytical engine."
        }
      ],
      "examples": [
        { "prompt": "Look at this clause", "expected_mode": "think" }
      ],
      "confidence_floor_overrides": {
        "think": 0.65
      }
    }
  ]
}
```