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

# List models

> List model identifiers available to the current account.

`GET /api/v1/cloud/models`

Lists the enabled models available to the current account. Use this endpoint to choose the `model` value when creating or updating an Agent.

## Headers

| Header          | Required | Description         |
| --------------- | -------- | ------------------- |
| `Authorization` | Yes      | `Bearer $QODER_PAT` |

## Query parameters

This endpoint does not currently accept query parameters.

## Example request

```bash theme={null}
curl -X GET "https://api.qoder.com/api/v1/cloud/models" \
  -H "Authorization: Bearer $QODER_PAT"
```

## Example response

**HTTP 200 OK**

```json theme={null}
{
  "data": [
    {
      "id": "ultimate",
      "type": "model",
      "display_name": "Ultimate",
      "source": "system",
      "is_enabled": true,
      "is_new": false,
      "price_factor": 1.6,
      "efforts": ["low", "medium", "high", "xhigh", "max"],
      "default_effort": "high",
      "max_input_tokens": 1000000,
      "default_context_window": 200000,
      "available_context_windows": [200000, 400000, 1000000]
    }
  ],
  "has_more": false
}
```

## Response fields

| Field      | Type    | Description                                                              |
| ---------- | ------- | ------------------------------------------------------------------------ |
| `data`     | array   | Available [Model objects](/cloud-agents/api/models/schemas#model-object) |
| `has_more` | boolean | Always `false`; model listing is not paginated                           |

Each model object contains:

| Field                       | Type             | Description                                                                                                                     |
| --------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `id`                        | string           | Model identifier to pass as the Agent `model`                                                                                   |
| `type`                      | string           | Always `"model"`                                                                                                                |
| `display_name`              | string           | Human-readable model name                                                                                                       |
| `source`                    | string           | Model source, usually `system`; `user` for account-specific models                                                              |
| `is_enabled`                | boolean          | Whether the model is enabled and usable                                                                                         |
| `is_new`                    | boolean          | Whether the model is marked as new                                                                                              |
| `price_factor`              | number           | Optional relative price multiplier                                                                                              |
| `efforts`                   | array            | Optional supported reasoning effort levels, such as `none`, `low`, `medium`, `high`, `xhigh`, or `max`                          |
| `default_effort`            | string           | Optional default effort level when the upstream catalog designates one                                                          |
| `max_input_tokens`          | integer          | Maximum input context supported by the model, in tokens                                                                         |
| `default_context_window`    | integer          | Optional default context window (in tokens) to use when the Agent does not set one                                              |
| `available_context_windows` | array of integer | Optional user-selectable context window tiers (in tokens) accepted as `model.context_window` when creating or updating an Agent |

## Notes

* Only enabled models are returned.
* The response does not include internal routing, provider, secret, or `description` fields.
* The model catalog is resolved for the authenticated user and the service's configured scene. The default scene is `assistant`.

## Errors

| HTTP | Type                   | Trigger                                  |
| ---- | ---------------------- | ---------------------------------------- |
| 401  | `authentication_error` | PAT invalid or expired                   |
| 503  | `api_error`            | Model catalog is temporarily unavailable |

See [Errors](/cloud-agents/api/conventions/errors) for the full error envelope.

## Related

<CardGroup cols={2}>
  <Card title="Agent setup" icon="user-gear" href="/cloud-agents/define-agent">
    Create a reusable, versioned agent configuration.
  </Card>
</CardGroup>