---
title: "List all models and their properties"
method: GET
path: "/models"
tags: ["Models"]
---

# List all models and their properties

`GET /models`

## Query parameters

- `offset` integer, nullable — Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned
- `limit` integer — Maximum number of records to return (max 1000). When both offset and limit are omitted, the full list is returned
- `category` 'programming' | 'roleplay' | 'marketing' | 'marketing/seo' | 'technology' | 'science' | 'translation' | 'legal' | 'finance' | 'health' | 'trivia' | 'academia' — Filter models by use case category
- `supported_parameters` string — Filter models by supported parameter (comma-separated)
- `output_modalities` string — Filter models by output modality. Accepts a comma-separated list of modalities (text, image, audio, embeddings) or "all" to include all models. Defaults to "text".
- `sort` 'most-popular' | 'newest' | 'top-weekly' | 'pricing-low-to-high' | 'pricing-high-to-low' | 'context-high-to-low' | 'throughput-high-to-low' | 'latency-low-to-high' | 'intelligence-high-to-low' | 'coding-high-to-low' | 'agentic-high-to-low' | 'design-arena-elo-high-to-low' — Sort the returned models server-side. Prefer this over fetching the full list and sorting client-side. Options: pricing-low-to-high, pricing-high-to-low (average prompt/completion price), context-high-to-low (context length), throughput-high-to-low, latency-low-to-high (recent median performance), most-popular, top-weekly (tokens processed in the last week), newest (creation date), intelligence-high-to-low, coding-high-to-low, agentic-high-to-low (Artificial Analysis indices), design-arena-elo-high-to-low (best Design Arena ELO across arenas). Models without a score for the chosen benchmark are placed last. When omitted, the existing default ordering is preserved.
- `use_rss` string — Return results as RSS feed
- `use_rss_chat_links` string — Use chat links in RSS feed items
- `q` string — Free-text search by model name or slug.
- `input_modalities` string — Filter models by input modality. Comma-separated list of: text, image, audio, file.
- `context` integer — Minimum context length (tokens). Models with smaller context are excluded.
- `min_price` number, nullable — Minimum prompt price in $/M tokens.
- `max_price` number, nullable — Maximum prompt price in $/M tokens.
- `arch` string — Filter models by architecture/model family (e.g. GPT, Claude, Gemini, Llama).
- `model_authors` string — Filter models by the organization that created the model. Comma-separated list of author slugs.
- `providers` string — Filter models by hosting provider. Comma-separated list of provider names.
- `distillable` 'true' | 'false' — Filter by distillation capability. "true" returns only distillable models, "false" excludes them.
- `zdr` 'true' — When set to "true", return only models with zero data retention endpoints.
- `region` 'eu' | 'us' — Filter to models with endpoints in the given data region ("eu" or "us").
- `min_output_price` number, nullable — Minimum completion (output) price in $/M tokens.
- `max_output_price` number, nullable — Maximum completion (output) price in $/M tokens.
- `min_age_days` integer, nullable — Minimum model age in days since its creation date.
- `max_age_days` integer, nullable — Maximum model age in days since its creation date.
- `min_intelligence_index` number, nullable — Minimum Artificial Analysis intelligence index.
- `max_intelligence_index` number, nullable — Maximum Artificial Analysis intelligence index.
- `min_coding_index` number, nullable — Minimum Artificial Analysis coding index.
- `max_coding_index` number, nullable — Maximum Artificial Analysis coding index.
- `min_agentic_index` number, nullable — Minimum Artificial Analysis agentic index.
- `max_agentic_index` number, nullable — Maximum Artificial Analysis agentic index.
- `min_tool_success_rate` number, nullable — Minimum tool-calling success rate, as a fraction in [0, 1] (e.g. 0.9 = 90% of requests finishing with a tool_calls finish reason).
- `max_tool_success_rate` number, nullable — Maximum tool-calling success rate, as a fraction in [0, 1].

## Response `200`

Returns a list of models or RSS feed

- ModelsListResponse — List of available models
  - `data` Model[], required — List of available models — unresolved $ref
  - `links` object, required — Pagination links
    - `next` string, nullable, required — URL for the next page of results, or null if this is the last page
  - `total_count` integer, required — Total number of models matching the query

## Other responses

- `400` — Bad Request - Invalid request parameters or malformed input
- `403` — Forbidden - Authentication successful but insufficient permissions
- `500` — Internal Server Error - Unexpected server error

---

[API](https://skmtc.net/openrouterteam/apis/openrouter-api.md) · [All operations](https://skmtc.net/openrouterteam/apis/openrouter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openrouterteam/openrouter-api/revisions/e9b4d0948751/schema)