---
title: "List models with filters"
method: GET
path: "/v2/models"
tags: ["Model Catalog V2"]
---

# List models with filters

`GET /v2/models`

Returns paginated model list with filtering, sorting, and search capabilities.
No authentication required. Page size is 20.

## Query parameters

- `search` string
- `sort` 'newest' | 'price_input_low' | 'price_input_high' | 'context_length'
- `input_modalities` union
  - string
  - string[]
- `output_modalities` union
  - string
  - string[]
- `context_length_min` integer
- `context_length_max` integer
- `input_price_min` number
- `input_price_max` number
- `providers` union
  - string
  - string[]
- `supported_params` union
  - string
  - string[]
- `page` integer

## Response `200`

Filtered and paginated model list

- FilteredModelListResponse
  - `models` AIModel[]
    - `id` string — Model ID (e.g. openai/gpt-5)
    - `name` string — Display name
    - `description` string
    - `cutoff_date` string, date
    - `context_length` integer — Maximum context length in tokens
    - `architecture` object
      - `modality` string
      - `input_modalities` string[]
      - `output_modalities` string[]
      - `tokenizer` string
      - `instruct_type` string
    - `pricing` object
      - `cost` string
      - `prompt` string — Input price per token (USD string)
      - `completion` string — Output price per token (USD string)
      - `request` string
      - `image` string
      - `web_search` string
      - `internal_reasoning` string
      - `input_cache_read` string
      - `input_cache_read_image` string
      - `image_generation` string
      - `image_type` string
      - `image_details` object
    - `top_provider` object
      - `context_length` integer
      - `max_completion_tokens` integer
      - `is_moderated` boolean
    - `supported_parameters` string[]
    - `features` object
      - `structured_outputs` boolean
      - `function_calling` boolean
      - `tuning` boolean
      - `streaming` boolean
    - `speed` number
    - `endpoints` object[]
      - `title` string
      - `route` string
    - `reasoning` boolean — Whether the model supports reasoning
    - `tags` string[]
    - `created` integer
    - `provider` string — Provider name
  - `page` integer — Current page number
  - `limit` integer — Page size (always 20)
  - `total` integer — Total number of matching models

---

[API](https://skmtc.dev/liara-cloud/apis/ai-models.md) · [All operations](https://skmtc.dev/liara-cloud/apis/ai-models/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/liara-cloud/ai-models/revisions/0b6292b11352/schema)