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

# List models

> GET /v1/models — list the models available to the current key

Returns all models the current API key has permission to call.

## Request

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

No query parameters.

## Response

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1715750400,
      "owned_by": "openai"
    },
    {
      "id": "gpt-5.4-mini",
      "object": "model",
      "created": 1715750400,
      "owned_by": "openai"
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "created": 1715750400,
      "owned_by": "anthropic"
    }
  ]
}
```

## Get a single model

```bash theme={null}
curl https://openp.ai/v1/models/gpt-5.5 \
  -H "Authorization: Bearer $OPENPAI_API_KEY"
```

Returns:

```json theme={null}
{
  "id": "gpt-5.5",
  "object": "model",
  "created": 1715750400,
  "owned_by": "openai"
}
```

## Scope

* The list is limited by the **token's model scope** — if you set an allowlist when creating the token, only the allowlisted models are returned here.
* It's affected by the **user group**: only models accessible to the current group are returned.

## Uses

* Fetch once at client startup and cache locally as the options for a dropdown.
* Forward this endpoint in your own gateway / relay proxy so downstream users can query it.