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

# List models

> GET /v1/models — the live model catalog for your account.

<Note>
  Base URL: `https://api.orbitrage.ai/v1` · Auth: `Authorization: Bearer orb_…`
</Note>

```
GET /v1/models
```

Returns the models currently routable on your account, in OpenAI list format
with extra fields for tier, vision support, routing bias, and access mode. This is
the **authoritative** catalog — it reflects which providers are configured and any
[BYOK](/concepts/byok) keys you've saved.

## Example

```bash theme={null}
curl https://api.orbitrage.ai/v1/models \
  -H "Authorization: Bearer $ORBITRAGE_API_KEY"
```

## Response

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "DeepSeek-V4-Flash",
      "object": "model",
      "tier": "mid",
      "vision": false,
      "bias": "mixed",
      "byok_required": false,
      "byok_ready": true
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "tier": "frontier",
      "vision": true,
      "bias": "mixed",
      "byok_required": true,
      "byok_provider": "anthropic",
      "byok_ready": false
    }
  ]
}
```

| Field           | Meaning                                                                                                                                                                                             |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`            | The model id you pass in `model` to pin it.                                                                                                                                                         |
| `tier`          | `basic`, `mid`, `high`, `frontier`, or `image`. See [Routing](/concepts/routing).                                                                                                                   |
| `vision`        | Whether the model accepts image content.                                                                                                                                                            |
| `bias`          | Routing hint: `chat`, `code`, `mixed`, or `reasoning`.                                                                                                                                              |
| `byok_required` | `true` for closed-weight frontier chat models — they run only on your own provider key, and Orbitrage bills \$0 for their tokens.                                                                   |
| `byok_provider` | Present when `byok_required` — the vendor whose key you need (`openai`, `anthropic`, `google`, `xai`).                                                                                              |
| `byok_ready`    | Whether this model is callable **right now** on your org. `false` on a `byok_required` model means you haven't saved and enabled that vendor's key yet; calling it returns `403 byok_key_required`. |

<Tip>
  Use this endpoint to populate a model picker, or to discover the exact ids to
  pin. Filter on `byok_ready` to show only what your organization can call today,
  and use `byok_required` to render a "BYOK" badge and an *Add key* link for the
  rest. For pricing per model, see [Models](/concepts/models).
</Tip>