---
title: "List the model catalog"
method: GET
path: "/v2/model-catalog"
tags: ["Model Catalog"]
---

# List the model catalog

`GET /v2/model-catalog`

Returns every model orq offers, optionally filtered, searched and sorted. Use `starting_after` or `ending_before` to page through the collection.

## Query parameters

- `limit` integer
- `starting_after` string
- `ending_before` string
- `provider` string[]
- `endpoint` string[]
- `input_modality` string[]
- `output_modality` string[]
- `location` string[]
- `type` string[]
- `status` string[]
- `supported_parameter` string[]
- `tier` string[]
- `offering_of` string
- `deprecated` boolean
- `search` string
- `sort_by` string
- `order` string

## Response `200`

OK

- ListModelCatalogResponse
  - `object` string, required — Object discriminator for list responses; always `list`.
  - `data` Model[], required — Page of catalog entries.
    - `id` string, required — Catalog identifier, `<provider>/<model>` (for example `openai/gpt-4o`).
    - `created` string, required — When orq listed this offering, Unix seconds (string-encoded int64 in JSON).
    - `deprecation` string — When this offering stops being served, Unix seconds (string-encoded int64 in JSON): orq's own sunset date if one is set, otherwise the developer's announced deprecation date. Absent when neither is set.
    - `name` string, required — Display name shown in the orq model garden.
    - `description` string, required — Short model description.
    - `provider` ModelProvider, required
      - `id` string, required — Catalog provider key (openai, anthropic, aws, ...).
      - `name` string, required — Provider display name.
      - `logo` string, required — Absolute URL of the provider logo. Empty when no logo is known.
      - `docs_url` string, required — Provider documentation URL.
      - `pricing_url` string, required — Provider pricing page URL.
    - `endpoints` string[], required — API endpoints this offering exposes (chat, batch, ...).
    - `modalities` ModelModalities, required
      - `input` string[], required — Modalities this offering accepts as input.
      - `output` string[], required — Modalities this offering produces as output.
    - `offering_of` string, required — Provider-independent model reference this offering serves, `<developer>/<stem>`.
    - `pricing` object — Resolved commercial pricing, including service-tier variants. Each variant carries a `when` CEL condition string evaluated against `input_tokens`, `output_tokens`, `total_tokens` and `tier`; all variants whose condition is true are merged onto the base pricing in order, later variants winning per field. Absent when this offering has no representable token-based pricing.
    - `supported_parameters` ModelParameter[], required — Playground and API parameters this offering exposes.
      - `name` string, required — Display name shown in the playground.
      - `parameter` string, required — API parameter key (e.g. `temperature`, `maxTokens`).
      - `type` string, required — Widget type: slider, select, toggle or text.
      - `description` string, required — Help text shown to playground users.
    - `supported_tiers` string[], required — Paid service tier names available to this offering.
    - `context_window` string — Maximum input context size in tokens (string-encoded int64 in JSON). Absent when not applicable.
    - `max_output_tokens` string — Maximum output size in tokens (string-encoded int64 in JSON). Absent when not applicable.
    - `location` string[], required — Regions this offering routes to, lowercased.
    - `artificial_intelligence` ModelArtificialAnalysis
      - `slug` string, required — Artificial Analysis model slug.
      - `intelligence_index` number, double — Artificial Analysis intelligence index. Absent when unmeasured.
      - `evaluations` object — Benchmark scores by evaluation key. A `null` value means the evaluation exists but is unmeasured for this model.
      - `release_date` string — Artificial Analysis recorded release date. Empty when unknown.
      - `median_output_tokens_per_second` number, double — Measured output throughput, tokens per second. Absent when unmeasured.
      - `median_time_to_first_token_seconds` number, double — Measured time to first token, seconds. Absent when unmeasured.
    - `status` string, required — Catalog lifecycle: active, preview or deprecated.
    - `type` string, required — Task type: chat, completion, embedding, image, ...
    - `knowledge_cutoff` string, required — Training-data cutoff (YYYY-MM). Empty when unset.
    - `release_date` string, required — Public release date (YYYY-MM-DD). Empty when unset.
  - `has_more` boolean, required — Whether more entries are available in the selected pagination direction.

---

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