---
title: "List available models"
method: GET
path: "/api/{workspaceID}/v1/models"
tags: ["Models"]
---

# List available models

`GET /api/{workspaceID}/v1/models`

## Request

- Base URL: `https://ai.liara.ir`
- URL: `https://ai.liara.ir/api/{workspaceID}/v1/models`
- Auth: API key in header `Authorization`

Lists all AI models available for inference in an OpenAI-compatible format.

## Path parameters

- `workspaceID` string, required

## Response `200`

List of models

- ModelsListResponse
  - `object` 'list'
  - `data` ModelItem[]
    - `id` string: Model ID
    - `name` string: Display name
    - `description` string
    - `context_length` integer
    - `architecture` object
      - `input_modalities` string[]
      - `output_modalities` string[]
    - `pricing` object
      - `prompt` string
      - `completion` string
    - `supported_parameters` string[]

## Other responses

- `401`: Missing authentication

## Changes

- **2026-11-02** `4fb178d7845f`: 1 warning
  - removed the optional property `data/items/top_provider` from the response with the `200` status

[Operation history](https://skmtc.dev/liara-cloud/apis/ai-chat-completions/changes/api/:workspaceID/v1/models/get.md)

---

[API](https://skmtc.dev/liara-cloud/apis/ai-chat-completions.md) - [All operations](https://skmtc.dev/liara-cloud/apis/ai-chat-completions/llms.txt) - [OpenAPI document](https://skmtc.dev/liara-cloud/apis/ai-chat-completions/revisions/c34e1fe0a4a3?raw)