Skip to main content
GET
List models filtered by user provider preferences, privacy settings, and guardrails

Authorizations

Authorization
string
header
required

API key as bearer token in Authorization header

Query Parameters

offset
integer | null
default:0

Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned

Required range: x >= 0
Example:

0

limit
integer
default:500

Maximum number of records to return (max 1000). When both offset and limit are omitted, the full list is returned

Required range: 1 <= x <= 1000
Example:

500

output_modalities
string

Filter models by output modality. Accepts a comma-separated list of modalities (text, image, embeddings, audio, video, rerank, decisions, speech, transcription) or "all" to include all models. Defaults to "text".

Example:

"text"

sort
enum<string>

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.

Available options:
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
Example:

"newest"

client
enum<string>

Filter models and presets by the named harness's eligibility policy: tool calling is required, and when one of your guardrails sets enforce_first_party_harness_models, only the harness vendor's own models remain (OpenAI for codex, Anthropic for claude_code and claude_desktop). When your workspace's Managed Machines policy sets a model list for that harness, only the listed models remain, and a preset remains only while every model it routes to is listed. This filter doesn't apply the harness's ranking, caps or Claude Desktop model ID aliases, so returned IDs stay routable. One of: claude_code, claude_desktop, codex. Omit it to get every model you can use.

Available options:
claude_code,
claude_desktop,
codex
Example:

"codex"

Response

Returns a list of models filtered by user provider preferences

List of available models

data
object[]
required

List of available models

Example:

Pagination links

total_count
integer
required

Total number of models matching the query

Example:

150