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

# List models

> List the TokenChange models your inference key can call with GET /v1/models, in the OpenAI models list format, for use with SDKs and model pickers.

Returns the models your inference key can call, in the OpenAI models list format.

* A key scoped to all endpoints sees every active model in the catalog.
* A key limited to specific endpoints sees only the models those endpoints serve.

For prices, capabilities and endpoints, use the REST API's [`GET /v1/models`](https://docs.tokenchange.io/api-reference/models/list-models) or browse the [catalog](https://tokenchange.io/models).

## Request

**Authorization** `string` *required*

`Bearer ask_...`, an [inference key](https://docs.tokenchange.io/guides/api-keys.md).

```bash curl theme={null}
curl https://inference.tokenchange.io/v1/models \
  -H "Authorization: Bearer $TOKENCHANGE_API_KEY"
```

```python Python theme={null}
for model in client.models.list():
    print(model.id)
```

```javascript JavaScript theme={null}
for await (const model of client.models.list()) {
  console.log(model.id);
}
```

## Response

**object** `string`

`list`.

**data** `object[]`

**properties**

**id** `string`

The model slug. Pass it as `model` in completion requests.

**object** `string`

`model`.

**created** `integer`

When the model was added to the catalog, as a Unix timestamp.

**owned\_by** `string`

The organization that publishes the model.

```json Response theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "<model-slug>",
      "object": "model",
      "created": 1767225600,
      "owned_by": "<model-publisher>"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.