List Models

List all models that are currently enabled and available for your tenant.

GET /v1/models

Authentication required. No specific capability is needed — any valid API key or JWT can list models.

Response

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4",
      "object": "model",
      "created": 1709000000,
      "owned_by": "openai",
      "capabilities": ["chat", "completions"],
      "context_window": 128000,
      "max_output_tokens": 4096
    },
    {
      "id": "claude-3-opus-20240229",
      "object": "model",
      "created": 1709000000,
      "owned_by": "anthropic",
      "capabilities": ["chat"],
      "context_window": 200000,
      "max_output_tokens": 4096
    },
    {
      "id": "text-embedding-3-small",
      "object": "model",
      "created": 1709000000,
      "owned_by": "openai",
      "capabilities": ["embeddings"],
      "context_window": 8191,
      "max_output_tokens": null
    }
  ]
}

Response Fields

Field	Type	Description
object	string	Always "list".
data	array	Array of model objects.
data[].id	string	The model identifier used in API requests.
data[].object	string	Always "model".
data[].created	integer	Unix timestamp of when the model configuration was created.
data[].owned_by	string	The provider slug (e.g. openai, anthropic, google).
data[].capabilities	string[]	List of capabilities this model supports (e.g. chat, embeddings, images).
data[].context_window	integer	Maximum input context window in tokens.
data[].max_output_tokens	integer | null	Maximum output tokens the model can generate.

Filtering

The returned list is filtered by:

1. Enabled providers — only models from providers that are enabled (either globally or for your tenant) are included.
2. Enabled models — only model configurations marked as enabled are returned.
3. Tenant restrictions — if your tenant has an allowedModels list configured, only those models appear.

Example

curl https://your-gateway.example.com/v1/models \
  -H "Authorization: Bearer aigw_sk_your_api_key"