Skip to main content
GET
List Provider Models Route

Authorizations

Authorization
string
header
required

Bearer token: an organization API key (ak_…) created under Settings → API Keys, or a dashboard user session token. Agent keys (xe_…) are not accepted here. Endpoints marked as user-only in their description reject organization keys with 403.

Path Parameters

provider_id
string<uuid>
required

Response

Successful Response

The models a provider can call. live is the upstream's own list (through the runtime, or OpenRouter's public list); directory is the public model directory's list for the entry (models.dev), answered when no live list can be had (no key yet, no discovery, a failed or unconfigured runtime); catalog is the catalog's suggestions, when the entry has no directory list or the directory cannot be reached. error says why a live list was refused (the runtime's fixed message), or is null.

models
ProviderModelOption · object[]
required
source
enum<string>
required
Available options:
live,
directory,
catalog
error
string | null