# List chat models

`GET https://api.endless.app/chat-models`

Source: https://endless.app/docs/api/chat-models/list

Lists the chat models the caller can read.

## Authentication

- `bearerAuth`: HTTP bearer (JWT)

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | integer | no |  |
| `page_size` | query | integer | no |  |
| `search` | query | string | no |  |
| `owners` | query | string \| array<string> | no |  |
| `plans` | query | string \| array<string> | no |  |
| `visibility` | query | "staff" \| "public" | no |  |
| `state` | query | "active" \| "retired" \| "all" | no |  |
| `readiness` | query | "runnable" \| "unrunnable" | no |  |
| `sort` | query | "name" \| "codename" \| "position" \| "created" \| "updated" | no |  |
| `direction` | query | "asc" \| "desc" | no |  |
| `Endless-Api-Version` | header | string | no | Pin the caller to an API major (`1`). Omit to accept the current version. A major this deployment cannot serve is refused with 400 `unsupported_api_version`. |

## Responses

### 200 OK

Content type: `application/json` — object

- `items` (array<object>, required)
  - `id` (string (uuid), required)
  - `codename` (string, required)
  - `name` (string, required)
  - `owner` (string | null, required)
  - `description` (string | null, required)
  - `thinking_options` (string | number | boolean | null | object | array<any | null> | null, required)
  - `cost_input` (string, required)
  - `cost_output` (string, required)
  - `cost_cache_read` (string, required)
  - `cost_cache_write` (string, required)
  - `minimum_required_plan` ("hobby" | "basic" | "pro" | "business" | null, required)
  - `position` (number, required)
  - `staff` (boolean, required)
  - `deleted_at` (string (date-time) | null, required)
  - `deleted_by_id` (string | null, required)
  - `created_at` (string (date-time), required)
  - `updated_at` (string (date-time), required)
  - `variant_count` (number, required)
  - `serving` (object | null, required)
    - `variant_id` (string, required)
    - `provider` ("gateway" | "vertex", required)
    - `provider_model_id` (string, required)
    - `priority` (number, required)
    - `mirror_name` (string | null, required)
    - `mirror_missing` (boolean, required)
    - `mirror_deprecated` (boolean, required)
    - `vision` (boolean, required)
    - `knowledge_cutoff` (string | null, required)
  - `unrunnable` (boolean, required)
- `total` (number, required)
- `page` (number, required)
- `page_size` (number, required)
- `available_owners` (array<string>, required)

### Errors

- `400` (Error): The request is malformed, or failed input validation. `message` names the field and the rule it broke; `data.issues` carries them individually.
- `401` (Error): No bearer token, or a token that failed verification.
- `402` (Error): The workspace has no credits left, or the caller is over a spending limit.
- `403` (Error): Authenticated, but the caller's role in this workspace does not carry the permission this operation needs.
- `409` (Error): The request is well-formed, but the resource's current state forbids it — a taken name, a last admin, a limit already reached.
- `429` (Error): The caller has spent its rate-limit window. `Retry-After` says when to come back.
- `500` (Error): The request failed on our side. Safe to retry an idempotent operation with backoff.