# List models

Returns the models a chat can run on. Pass a model's `id` as `model` when you [create a chat](https://betterstack.com/docs/ai-sre/api/chats/create/) or [reply to one](https://betterstack.com/docs/ai-sre/api/chats/reply/).

[endpoint]
base_url = "https://chat.betterstack.com"
path = "/api/v2/chats/models"
method = "GET"

[[query_param]]
name = "team_name"
description = "Selects the team whose default model is flagged when using a [global API token](https://betterstack.com/docs/ai-sre/api/getting-api-token/#get-a-global-api-token). Without it, a token that spans several teams flags no model as the default."
required = false
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"
[/endpoint]

[responses]
[[response]]
status = 200
description = '''Returns every model a chat can run on. Prices are in US dollars per million tokens at pay-as-you-go rates, and the default model is the one a chat created without a model runs on.'''
body = '''{
  "data": [
    {
      "id": "deepseek/deepseek-v4.1-flash",
      "type": "model",
      "attributes": {
        "name": "DeepSeek V4.1 Flash",
        "provider": "DeepSeek",
        "tier": "fast",
        "us_hosted": true,
        "capabilities": {
          "images": true
        },
        "input_usd_per_million_tokens": 0.39,
        "output_usd_per_million_tokens": 1.56,
        "default": true
      }
    },
    {
      "id": "openai/gpt-5.6-sol",
      "type": "model",
      "attributes": {
        "name": "GPT-5.6 Sol",
        "provider": "OpenAI",
        "tier": "advanced",
        "us_hosted": false,
        "capabilities": {
          "images": true
        },
        "input_usd_per_million_tokens": 2.4,
        "output_usd_per_million_tokens": 12.0,
        "default": false
      }
    },
    {
      "id": "anthropic/claude-opus-5.5",
      "type": "model",
      "attributes": {
        "name": "Claude Opus 5.5",
        "provider": "Anthropic",
        "tier": "frontier",
        "us_hosted": false,
        "capabilities": {
          "images": true
        },
        "input_usd_per_million_tokens": 4.4,
        "output_usd_per_million_tokens": 22.0,
        "default": false
      }
    }
  ]
}'''

[[response]]
status = 401
description = '''Unauthorized'''
body = '''{
  "errors": "Invalid authentication"
}'''
[/responses]

#### Example cURL

```shell
[label Example]
curl --request GET \
  --url https://chat.betterstack.com/api/v2/chats/models \
  --header "Authorization: Bearer $TOKEN"
```