---
title: "List available LLMs"
method: GET
path: "/v1/ai/llms"
tags: ["AI"]
---

# List available LLMs

`GET /v1/ai/llms`

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/ai/llms`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

List the LLMs the caller may pass as `requestedLlm` on the [Create AI job](/api/ai/create-ai-job) and [Generate a query](/api/ai/generate-a-query) endpoints.

The response includes the organization's [approved LLMs](/ai/settings/llm-settings), [test-only](/ai/settings/llm-settings#test-only) LLMs only for organization admins, only the default for an embedded user, and only the [downgrade LLM](/ai/settings/usage#downgrade) while the organization is over its AI credit downgrade threshold.

## Query parameters

- `userId` string, uuid

## Response `200`

Available LLMs retrieved successfully.

- object
  - `llms` object[], required: The LLMs the caller may pass.
    - `label` string, required: Display name, as it displays in the chat picker
    - `description` string, required: The LLM's description.
    - `model` string, required: The LLM's catalog name on an Omni-managed provider (e.g. `claude-sonnet-5`) or the LLM's ID if using [Bring your own key](/ai/settings/model-providers/index).
    - `provider` 'bedrock' | 'anthropic' | 'openai' | 'grok' | 'snowflake_cortex' | 'openai_compatible' | 'fireworks' | 'fireworks_managed' | 'databricks_genie' | 'vertex_ai', required: The LLM provider. Use this value when passing `requestedLlm.provider`.
    - `thinkingLevels` string[], required: The thinking levels this LLM supports, any of which may be passed as `requestedLlm.thinking`.
    - `isDefault` boolean, required: Whether this is the LLM a job or query runs on when it doesn't name a `requestedLlm`.

## Other responses

- `401`: Missing or invalid API key.
- `403`: AI query generation is not enabled for the organization, the user cannot use AI, or a Personal Access Token passed another user's `userId`.
- `404`: The `userId` does not name a user in this organization.
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)
- `500`: Internal Server Error

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v1/ai/llms/get.md)

---

[API](https://skmtc.dev/omni/apis/omni-api.md) - [All operations](https://skmtc.dev/omni/apis/omni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omni/apis/omni-api/revisions/43290040f88f?raw)