Skip to main content
GET
/
models
List models
curl --request GET \
  --url https://api.dottxt.ai/v1/models \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "created": 1703187200,
      "id": "Qwen/Qwen3-30B-A3B-FP8",
      "object": "model",
      "owned_by": "qwen"
    }
  ],
  "object": "list"
}
Use this endpoint to discover exactly which model IDs your key can access before sending chat or embeddings requests.

​
Base URL

https://api.dottxt.ai/v1

​
Practical request pattern

curl https://api.dottxt.ai/v1/models \
  -H "Authorization: Bearer $DOTTXT_API_KEY"

​
Example response shape

{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-oss-20b",
      "object": "model"
    }
  ]
}

​
Notes

  • Use data[].id directly in model for POST /chat/completions.
  • If auth is missing or invalid, this endpoint returns 401.

Authorizations

​
Authorization
string
header
required

API key authentication. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API keys can be created and managed in the dashboard.

Response

List of models your API key can access.

Response for listing available models.

​
data
object[]
required

The list of available models.

​
object
string
required

The object type, always "list".

Example:

"list"