> ## Documentation Index > Fetch the complete documentation index at: https://docs.orq.ai/llms.txt > Use this file to discover all available pages before exploring further. # List the model catalog > Returns every model orq offers, optionally filtered, searched and sorted. Deprecated models are never listed; fetch one directly by id to inspect it. Unset `limit` returns the whole catalog. Use `starting_after` or `ending_before` to page through the collection. ## OpenAPI ````yaml get /v2/model-catalog openapi: 3.1.0 info: title: orq.ai API version: '2.0' description: orq.ai API documentation servers: - url: https://my.orq.ai security: - ApiKey: [] tags: - name: Chunking description: Split text into smaller chunks for retrieval and generation workflows. - name: File Systems description: >- Create and manage persistent file systems that agents and MCP clients read from and write to. - name: Knowledge Bases description: Create and manage knowledge bases used by agents and retrieval workflows. - name: Memory Stores description: Create and manage memory stores, memories, and memory documents. - name: Evals description: Run an evaluator against a conversation and its result - name: Logs description: >- OpenTelemetry log query API. Search, filter, aggregate, and facet log records ingested via OTLP. - name: Reporting description: >- GenAI reporting API over canonical analytics rollups. Accepts a metric name, time range, grain, group-by, and filters; returns a typed time series and optional totals. - name: Traces description: >- Query and inspect ingested trace data: search trace summaries, aggregate metrics, and read individual traces and their spans. - description: List models available through the AI Router. name: Models - name: Policies - name: Alerts description: >- Alerts evaluate a Reporting API metric on a fixed interval and fire notifications through notifiers when the value breaches a threshold. Each breach opens a trigger that tracks the incident until the value recovers. - name: Annotation Queues description: Annotation queues collect spans for human review. - name: API keys description: >- API keys authenticate programmatic access to the workspace. They expose opaque tokens, per-domain access grants, and budget and rate-limit constraints. - name: Audit Logs description: Audit logs record workspace entity changes and access-relevant events. - name: Budgets description: >- Budgets govern spend, token usage, and request rate across six scopes: workspace, project, identity, API key, provider, and model. Every applicable budget is enforced, and the most restrictive limit applies per dimension. - name: Files description: File upload and retrieval operations. - name: Guardrail Rules description: >- Guardrail Rules conditionally enforce evaluators and plugins for AI Gateway traffic. Rules may be scoped to a project or the whole workspace. - name: Hub description: Hub items are reusable templates available to a workspace. - name: Identities description: >- Identities represent end users from your system for usage and engagement tracking. - name: Management keys description: >- Management keys are workspace-scoped credentials that authenticate programmatic access to workspace administration surfaces (API keys, budgets). Unlike project-scoped API keys, a management key always operates at the workspace level. - name: MCP Gateway description: >- Register upstream MCP servers, discover and sync their tools, and assemble gateways that expose a curated tool surface to MCP clients. - name: Model Catalog description: >- Browse the orq.ai model catalog: every model orq offers, across every provider, with pricing, capabilities and benchmark data. List endpoints only return models that are not deprecated. This API is public, requires no authentication, and is rate limited to 120 requests per minute per IP. Responses carry a 5-minute cache-control max-age. - name: Notifiers description: Notifier destinations used to send delivery and workflow notifications. - name: Projects description: Projects organize resources within a workspace - name: Routing Rules description: >- Routing Rules conditionally select models and enforce request plugins for AI Gateway traffic. Rules are evaluated by ascending priority and may be scoped to a project or the whole workspace. - name: Threads description: Threads group related trace invocations and their aggregate usage - name: Skills description: >- Skills are modular instructions you can use to codify processes and conventions - name: Smart Routers description: >- Create and manage workspace Smart Routers. A Smart Router selects a model from an eligible pool for each request according to a quality, balanced, or cost profile. - name: Webhooks description: >- Create and manage webhooks that deliver workspace events to external HTTPS endpoints. - name: Workspaces description: >- A workspace is the tenant. Create is called from a user session during onboarding; Get, List, and Update are the public management surface. - name: Workspace Security description: >- Workspace-level domain verification and IP allowlist controls. These operations are restricted to workspace administrators. - name: Workspace Settings description: >- Workspace-level settings managed with a workspace credential. A workspace is the tenant, so these settings are a singleton — there is nothing to create or delete, only read and update. - name: Responses - description: Run agents on a cron cadence. Minimum firing interval is 1 hour. name: Agent Schedules - name: Embeddings - name: Telemetry description: >- Unified query envelope for traces, metrics, and logs. One request shape, one filter dialect, and one response shape per source, validated by a per-source registry. - description: Beta. Run typed classification questions against a classify model. name: Classify - description: Search Gateway with managed credits or BYOK. name: Web Search externalDocs: url: https://docs.orq.ai description: orq.ai Documentation paths: /v2/model-catalog: get: tags: - Model Catalog summary: List the model catalog description: >- Returns every model orq offers, optionally filtered, searched and sorted. Deprecated models are never listed; fetch one directly by id to inspect it. Unset `limit` returns the whole catalog. Use `starting_after` or `ending_before` to page through the collection. operationId: ModelCatalogList parameters: - name: limit in: query description: >- Page size, 1–1000. Unset returns every non-deprecated model in one response. schema: type: integer format: int32 - name: starting_after in: query description: |- Cursor for forward pagination. Set to the `id` of the last item from the previous page. schema: type: string - name: ending_before in: query description: |- Cursor for backward pagination. Set to the `id` of the first item from the previous page. schema: type: string - name: provider in: query description: |- Filter by catalog provider key. Repeat to match any of several providers. schema: type: array items: type: string - name: endpoint in: query description: Filter by API endpoint. Repeat to match any of several endpoints. schema: type: array items: type: string - name: input_modality in: query description: Filter by input modality. Repeat to match any of several modalities. schema: type: array items: type: string - name: output_modality in: query description: >- Filter by output modality. Repeat to match any of several modalities. schema: type: array items: type: string - name: location in: query description: Filter by region. Repeat to match any of several regions. schema: type: array items: type: string - name: feature in: query description: |- Filter by normalized feature name. Repeat to match any of several features. schema: type: array items: type: string - name: supported_parameter in: query description: |- Filter by supported parameter key. Repeat to match any of several parameters. schema: type: array items: type: string - name: tier in: query description: |- Filter by supported service tier. Repeat to match any of several tiers. schema: type: array items: type: string - name: offering_of in: query description: >- Filter to offerings of one base model reference, `/`. schema: type: string - name: search in: query description: >- Case-insensitive substring search over `id`, `name` and `description`. schema: type: string - name: sort_by in: query description: Field to sort by. schema: type: string - name: order in: query description: Sort order. Defaults to ascending. schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ListModelCatalogResponse' security: [] x-code-samples: - lang: curl label: Core - List the model catalog source: | curl --get 'https://my.orq.ai/v2/model-catalog' \ --data-urlencode 'provider=openai' \ --data-urlencode 'limit=10' - lang: python label: Python - List the model catalog source: | import os from orq_ai_sdk import Orq client = Orq(api_key=os.environ["ORQ_API_KEY"]) page = client.model_catalog.list( provider="openai", limit=10, ) for model in page.data: print(model.id, model.name) - lang: typescript label: Node.js - List the model catalog source: | import { Orq } from '@orq-ai/node'; const client = new Orq({ apiKey: process.env.ORQ_API_KEY, }); const page = await client.modelCatalog.list({ provider: 'openai', limit: 10, }); for (const model of page.data) { console.log(model.id, model.name); } components: schemas: ListModelCatalogResponse: required: - object - data - has_more type: object properties: object: type: string description: Object discriminator for list responses; always `list`. data: type: array items: $ref: '#/components/schemas/Model' description: Page of catalog entries. has_more: type: boolean description: |- Whether more entries are available in the selected pagination direction. Model: required: - id - created - name - description - provider - endpoints - modalities - offering_of - supported_parameters - supported_tiers - location - features - deprecated - zdr type: object properties: id: type: string description: >- Catalog identifier, `/` (for example `openai/gpt-4o`). created: type: string description: When orq listed this offering, as an RFC 3339 UTC timestamp. format: date-time deprecation: type: string description: |- When this offering stops being served, as an RFC 3339 UTC timestamp: orq's own sunset date if one is set, otherwise the developer's announced deprecation date. Absent when neither is set. format: date-time name: type: string description: Display name shown in the orq model garden. description: type: string description: Short model description. provider: allOf: - $ref: '#/components/schemas/ModelProvider' description: Provider that serves this offering. endpoints: type: array items: type: string description: API endpoints this offering exposes (chat, batch, ...). modalities: allOf: - $ref: '#/components/schemas/ModelModalities' description: Content modalities this offering consumes and produces. offering_of: type: string description: >- Provider-independent model reference this offering serves, `/`. pricing: type: object description: |- 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: type: array items: type: string description: >- API parameter keys this offering accepts, snake_case (e.g. `temperature`, `max_tokens`). supported_tiers: type: array items: type: string description: Paid service tier names available to this offering. context_window: type: string description: |- Maximum input context size in tokens (string-encoded int64 in JSON). Absent when not applicable. location: type: array items: type: string description: Regions this offering routes to, lowercased. artificial_intelligence: type: object description: >- Artificial Analysis benchmark scores keyed by evaluation name. Absent when unavailable for this offering. features: type: array items: type: string description: |- Normalized capability names this offering supports, snake_case and alphabetical (e.g. `json_mode`, `tool_calling`, `vision`, `web_search`). deprecated: type: boolean description: |- True when this offering is deprecated, whether or not a deprecation date is known. `deprecation` carries the date when one is announced. zdr: type: boolean description: True when this offering guarantees zero data retention. ModelProvider: required: - id - logo type: object properties: id: type: string description: Catalog provider key (openai, anthropic, aws, ...). logo: type: string description: Absolute URL of the provider logo. Empty when no logo is known. ModelModalities: required: - input - output type: object properties: input: type: array items: type: string description: Modalities this offering accepts as input. output: type: array items: type: string description: Modalities this offering produces as output. securitySchemes: ApiKey: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.