Skip to main content
GET
List models (OpenAI-compatible)

Authorizations

Authorization
string
header
required

API key authentication. Pass your API key as a Bearer token.

Query Parameters

type
string

Comma-separated entry kinds to return: model, pool, dynamic_route. Omit for all three.

Example:

"pool,dynamic_route"

format
enum<string>

Set to codex for the native authenticated Codex remote catalog (models, with tool-capable LLMs and routes only). Absent or empty returns the unchanged OpenAI models.list shape (data). Other values return 400. Native catalogs apply the same caller policy and entitlement checks and fail with 503 if route discovery is unavailable. Responses exceeding Codex's 1 MiB limit return 400; use a narrower type filter.

Available options:
codex,
selected_model
string

For format=codex, retain this exact authorized tool-capable model even outside the type filter and place it first. Unknown, denied, empty and unsupported selections uniformly return 400. Does not change authorization or inference routing.

client_version
string

Codex appends its version to native catalog requests. Accepted for compatibility; does not change the catalog.

view
enum<string>

Which entries to list. all lists every catalog row, pool and dynamic route. simplified lists each model once: its pool's bare name when it routes across providers, otherwise its one pooled catalog row; service-tier and extra-region rows are left out. recommended narrows simplified to a short list of current models Opper recommends (the catalog's featured models), plus the organization's dynamic routes. Omit to use the organization's setting (Model list for API keys, in the platform's API key settings), which is all unless changed. The view changes only what is listed: every id stays callable, and Comply rules apply in every view. Other values return 400. With format=codex a selected_model is still retained when the view leaves it out.

Available options:
all,
simplified,
recommended

Response

Successful response

data
object[]
required
object
string
required
Last modified on August 7, 2026