# List all models across all providers

Source: <https://everruns.com/docs/api/operations/list_all_models/>

GET

/v1/models

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/models';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/models
```

* Production APIapp.everruns.com/api/v1/models

## Parameters

### Query Parameters

**service**

One of:

* string

  A typed service a provider driver can offer.

  Drivers declare supported services in code; catalog models persist their selected service. One provider account composes typed chat, decision and embedding drivers over shared authentication.

  string

  Allowed values: chat decisions embeddings realtime images rerank

* null

  null

Filter by typed model service.

**source**

One of:

* string

  How the model was added to the system

  string

  Allowed values: manual discovered predefined

  ##### Example

  ```plaintext
  predefined
  ```

* null

  null

Filter by model source (manual, discovered, predefined)

**include\_stale**

boolean

Include models that are stale (not seen in recent sync). Default: true

**favorites\_only**

boolean

Only return favorite models. Default: false

## Responses

### 200

List of all models

Media typeapplication/json

Response wrapper for list endpoints. All list endpoints return responses wrapped in a `data` field.

object

**data**

required

Array of items returned by the list operation.

Array

Wrapper that adds API and UI links to a serialized resource.

Uses `self_url` (not `url`) for the API link to avoid collision with resources that already have a `url` field (e.g. McpServer). The `allowed_actions` array carries state-aware hypermedia links — empty (and omitted from the wire shape) until the underlying resource opts into the convention by overriding `ResourceUrlable::allowed_actions`.

object

**capabilities**

required

Capability tags supported by this model.

Array\<string>

**created\_at**

required

Timestamp when this model was created (RFC 3339).

string format: date-time

**display\_name**

required

Human-readable display name.

string

**enabled**

required

Whether this model is selectable. Controls UI visibility AND server-side resolution: `ProviderResolverService` requires `enabled = true`, and org default-model validation rejects disabled models.

boolean

**healthy**

required

Derived: model is configured and ready for use. Currently means the joined provider is active and has an API key set; over time this may also incorporate live reachability checks. Not persisted.

boolean

**id**

required

Prefixed public identifier. See [ID Schema](https://everruns.com/docs/advanced/id-schema/).

string

**is\_favorite**

required

Whether this model is starred in the UI for quick access.

boolean

**is\_new**

Derived: a discovered model that is still disabled and appeared after the provider’s models were last reviewed. Not persisted.

boolean

**model\_id**

required

Provider-side model identifier as sent on the wire (e.g. `gpt-5.2`).

string

**model\_vendor**

One of:

* string

  Vendor/brand of the model, derived from the model registry. Drives UI branding (icons). `None` when the model id is not in the registry. Not persisted.

  string

  Allowed values: openai anthropic google nvidia qwen microsoft meta minimax mistral moonshot typesafe xai llmsim

* null

  null

**profile**

One of:

* object

  Readonly profile with model capabilities (limits, pricing, modalities). Not persisted.

  object

  **attachment**

  required

  Whether the model supports file/image attachments

  boolean

  **cost**

  One of:

  * object

    Cost per million tokens

    object

    **cache\_read**

    Cached read cost per million tokens (USD), if supported

    number | null format: double

    **cache\_write**

    Cache write cost per million tokens (USD); absent falls back to input.

    number | null format: double

    **cost\_tiers**

    Tiered pricing that applies when prompt tokens exceed context thresholds. When present, the highest matching tier replaces the base rates for the whole request.

    Array\<object>

    A pricing tier that activates above a context token threshold. For example, OpenAI charges higher rates for prompts exceeding 200K tokens.

    object

    **above\_tokens**

    required

    Context token threshold above which this tier applies

    integer format: int32

    **cache\_read**

    Cached read cost per million tokens (USD) for this tier, if supported

    number | null format: double

    **cache\_write**

    Cache write cost per million tokens (USD); absent falls back to input.

    number | null format: double

    **input**

    required

    Input cost per million tokens (USD) for this tier

    number format: double

    **output**

    required

    Output cost per million tokens (USD) for this tier

    number format: double

    **input**

    required

    Input cost per million tokens (USD)

    number format: double

    **output**

    required

    Output cost per million tokens (USD)

    number format: double

  * null

    null

  **decisions**

  One of:

  * object

    Typed semantics when this profile describes a decision model.

    object

    **calibrated**

    required

    Whether returned probabilities are calibrated native decision measurements.

    boolean

    **max\_choice\_options**

    Maximum options in one choice question, when known.

    integer | null

    **max\_score\_levels**

    Maximum levels in one score question, when known.

    integer | null

    **primitives**

    required

    Native primitive names supported by this profile (noul, choice or score).

    Array\<string>

    **request\_tokens**

    Maximum token count for the complete request, when known.

    integer | null

    **state\_tokens**

    Maximum token count for the evaluated state, when known.

    integer | null

  * null

    null

  **description**

  Short human-readable description of the model’s strengths and intended use

  string | null

  **family**

  required

  Model family (e.g., “gpt-5.6-sol”, “claude-sonnet-5”)

  string

  **knowledge**

  Knowledge cutoff date (YYYY-MM-DD format)

  string | null

  **last\_updated**

  Last updated date (YYYY-MM-DD format)

  string | null

  **limits**

  One of:

  * object

    Token limits

    object

    **context**

    required

    Maximum context window size in tokens

    integer format: int32

    **input**

    Maximum input tokens (if different from context - output)

    integer | null format: int32

    **max\_media**

    Maximum images or PDF pages per request

    integer | null format: int32

    **output**

    required

    Maximum output tokens

    integer format: int32

  * null

    null

  **modalities**

  One of:

  * object

    Supported modalities

    object

    **input**

    required

    Supported input modalities

    Array\<string>

    Allowed values: text image audio video pdf

    **output**

    required

    Supported output modalities

    Array\<string>

    Allowed values: text image audio video pdf

  * null

    null

  **name**

  required

  Display name of the model

  string

  **open\_weights**

  required

  Whether the model has open weights

  boolean

  **reasoning**

  required

  Whether the model has reasoning/chain-of-thought capabilities

  boolean

  **reasoning\_effort**

  One of:

  * object

    Reasoning effort configuration (for reasoning models)

    object

    **default**

    required

    Default reasoning effort for this model

    string

    Allowed values: none minimal low medium high xhigh max

    **values**

    required

    Available reasoning effort values for this model

    Array\<object>

    Named reasoning effort value for UI display

    object

    **name**

    required

    Display name (e.g., “Low”, “Medium”)

    string

    **value**

    required

    The API value (e.g., “low”, “medium”)

    string

    Allowed values: none minimal low medium high xhigh max

  * null

    null

  **release\_date**

  Release date (YYYY-MM-DD format)

  string | null

  **speed**

  One of:

  * object

    Speed (service tier) configuration, for models served with selectable latency/price tiers (OpenAI `service_tier`).

    object

    **default**

    required

    Default speed for this model

    string

    Allowed values: flex default priority fast ultrafast

    **values**

    required

    Available speed values for this model

    Array\<object>

    Named speed value for UI display

    object

    **cost\_multiplier**

    Price of this tier relative to the standard rate (e.g. `2.0` for Fast, `0.5` for Flex), applied to every token bucket. `None` when the tier’s rate is not recorded; cost estimates then use the standard rate.

    number | null format: double

    **name**

    required

    Display name (e.g., “Flex”, “Fast”)

    string

    **value**

    required

    The API value (e.g., “flex”, “priority”)

    string

    Allowed values: flex default priority fast ultrafast

  * null

    null

  **structured\_output**

  required

  Whether the model supports structured output (JSON mode)

  boolean

  **supported\_parameters**

  Provider-advertised request parameters supported by this model.

  Array\<string>

  **supports\_phases**

  Whether the model supports native execution phases (“commentary” / “final\_answer”). When true, the driver sends the `phase` field on assistant messages in the wire format. Currently supported by GPT-5.4 and newer via OpenAI Responses API.

  boolean

  **supports\_server\_compaction**

  Whether the direct provider API supports threshold server-side compaction.

  This is an explicit rollout control. Unknown models and provider surfaces that do not opt in remain disabled.

  boolean

  **temperature**

  required

  Whether temperature control is supported

  boolean

  **tool\_call**

  required

  Whether the model supports tool/function calling

  boolean

  **tool\_search**

  Whether the model supports tool\_search (deferred tool loading). When true, the driver can use namespaces and defer\_loading to reduce token usage for large tool sets. Currently supported by GPT-5.4 and newer.

  boolean

  **verbosity**

  One of:

  * object

    Verbosity configuration, for models that expose output-length control (OpenAI `verbosity`).

    object

    **default**

    required

    Default verbosity for this model

    string

    Allowed values: low medium high

    **values**

    required

    Available verbosity values for this model

    Array\<object>

    Named verbosity value for UI display

    object

    **name**

    required

    Display name (e.g., “Low”, “High”)

    string

    **value**

    required

    The API value (e.g., “low”, “high”)

    string

    Allowed values: low medium high

  * null

    null

* null

  Cost per million tokens

  object

  **cache\_read**

  Cached read cost per million tokens (USD), if supported

  number | null format: double

  **cache\_write**

  Cache write cost per million tokens (USD); absent falls back to input.

  number | null format: double

  **cost\_tiers**

  Tiered pricing that applies when prompt tokens exceed context thresholds. When present, the highest matching tier replaces the base rates for the whole request.

  Array\<object>

  A pricing tier that activates above a context token threshold. For example, OpenAI charges higher rates for prompts exceeding 200K tokens.

  object

  **above\_tokens**

  required

  Context token threshold above which this tier applies

  integer format: int32

  **cache\_read**

  Cached read cost per million tokens (USD) for this tier, if supported

  number | null format: double

  **cache\_write**

  Cache write cost per million tokens (USD); absent falls back to input.

  number | null format: double

  **input**

  required

  Input cost per million tokens (USD) for this tier

  number format: double

  **output**

  required

  Output cost per million tokens (USD) for this tier

  number format: double

  **input**

  required

  Input cost per million tokens (USD)

  number format: double

  **output**

  required

  Output cost per million tokens (USD)

  number format: double

* object

  null

* null

  Typed semantics when this profile describes a decision model.

  object

  **calibrated**

  required

  Whether returned probabilities are calibrated native decision measurements.

  boolean

  **max\_choice\_options**

  Maximum options in one choice question, when known.

  integer | null

  **max\_score\_levels**

  Maximum levels in one score question, when known.

  integer | null

  **primitives**

  required

  Native primitive names supported by this profile (noul, choice or score).

  Array\<string>

  **request\_tokens**

  Maximum token count for the complete request, when known.

  integer | null

  **state\_tokens**

  Maximum token count for the evaluated state, when known.

  integer | null

* object

  null

* null

  Token limits

  object

  **context**

  required

  Maximum context window size in tokens

  integer format: int32

  **input**

  Maximum input tokens (if different from context - output)

  integer | null format: int32

  **max\_media**

  Maximum images or PDF pages per request

  integer | null format: int32

  **output**

  required

  Maximum output tokens

  integer format: int32

* object

  null

* null

  Supported modalities

  object

  **input**

  required

  Supported input modalities

  Array\<string>

  Allowed values: text image audio video pdf

  **output**

  required

  Supported output modalities

  Array\<string>

  Allowed values: text image audio video pdf

* object

  null

* null

  Reasoning effort configuration (for reasoning models)

  object

  **default**

  required

  Default reasoning effort for this model

  string

  Allowed values: none minimal low medium high xhigh max

  **values**

  required

  Available reasoning effort values for this model

  Array\<object>

  Named reasoning effort value for UI display

  object

  **name**

  required

  Display name (e.g., “Low”, “Medium”)

  string

  **value**

  required

  The API value (e.g., “low”, “medium”)

  string

  Allowed values: none minimal low medium high xhigh max

* object

  null

* null

  Speed (service tier) configuration, for models served with selectable latency/price tiers (OpenAI `service_tier`).

  object

  **default**

  required

  Default speed for this model

  string

  Allowed values: flex default priority fast ultrafast

  **values**

  required

  Available speed values for this model

  Array\<object>

  Named speed value for UI display

  object

  **cost\_multiplier**

  Price of this tier relative to the standard rate (e.g. `2.0` for Fast, `0.5` for Flex), applied to every token bucket. `None` when the tier’s rate is not recorded; cost estimates then use the standard rate.

  number | null format: double

  **name**

  required

  Display name (e.g., “Flex”, “Fast”)

  string

  **value**

  required

  The API value (e.g., “flex”, “priority”)

  string

  Allowed values: flex default priority fast ultrafast

* object

  null

* null

  Verbosity configuration, for models that expose output-length control (OpenAI `verbosity`).

  object

  **default**

  required

  Default verbosity for this model

  string

  Allowed values: low medium high

  **values**

  required

  Available verbosity values for this model

  Array\<object>

  Named verbosity value for UI display

  object

  **name**

  required

  Display name (e.g., “Low”, “High”)

  string

  **value**

  required

  The API value (e.g., “low”, “high”)

  string

  Allowed values: low medium high

* object

  null

* null

  null

**profile\_key**

required

Stable assigned profile identity.

string

**provider\_id**

required

Owning provider’s prefixed public identifier.

string

**provider\_name**

required

Joined provider display name.

string

**provider\_type**

required

Joined provider implementation type.

string

**service**

required

The typed service selected by this model.

string

Allowed values: chat decisions embeddings realtime images rerank

**source**

required

How this model entry was added (manually, discovered, or seeded as predefined).

string

Allowed values: manual discovered predefined

**stale**

Derived: a discovered model the provider no longer lists (not seen in its most recent sync). Kept, not deleted, so defaults and agents that use it can be fixed first. Not persisted.

boolean

**updated\_at**

required

Timestamp when this model was last updated (RFC 3339).

string format: date-time

**allowed\_actions**

State-aware hypermedia actions the caller can take on this resource next (e.g. `cancel`, `events`, `update`). Omitted from the wire shape when empty so resources that haven’t opted into the convention don’t grow their payloads.

Array\<object>

Agent-actionable link describing a follow-up the caller can take. Used in two contexts:

* **Error recovery** — `ErrorResponse.allowed_actions` carries `rel`s like `retry`, `retry-later`, `unarchive`, `get-existing` so the agent knows the right next call after a 4xx/429.
* **Entity hypermedia** — `WithUrls<T>.allowed_actions` carries state-aware `rel`s like `cancel`, `events`, `self`, `update` on the entity itself so the agent can follow links instead of reconstructing routes from prose.

The shape is intentionally identical across both contexts; the closed `rel` vocabulary distinguishes them.

object

**hint**

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”, “Cancel the active turn for this session.”).

string | null

**href**

Absolute (preferred) or relative URL the caller may invoke directly. **Always present on entity hypermedia actions** (`WithUrls<T>.allowed_actions`); **optional on error-recovery actions** (`ErrorResponse.allowed_actions`) where the matching `operation_id` is enough and the URI is implicit from the failed call.

string | null

**method**

HTTP method to use against `href`. Required for entity hypermedia actions; usually omitted on error-recovery actions where the same operation is retried with its original method.

string | null

**operation\_id**

OpenAPI `operationId` the caller should invoke. Lets an MCP client resolve the call without parsing `href`.

string | null

**rel**

required

Link relation describing the action. Examples: `self`, `cancel`, `pause`, `resume`, `events`, `retry`, `retry-later`, `unarchive`, `get-existing`, `delete`, `update`.

string

**schema\_ref**

OpenAPI `$ref` to the request-body schema, when the action takes one (e.g. `#/components/schemas/UpdateSessionRequest`). Lets a tool-calling agent fetch the input shape without scanning the whole spec.

string | null

**self\_url**

required

Full API endpoint URL for this resource.

string

**ui\_link**

required

Alias for `view_url`, used by command and MCP outputs.

string

**view\_url**

required

Full UI URL for viewing this resource.

string

##### Example

```json
{
  "data": [
    {
      "capabilities": [
        "text",
        "tools",
        "vision",
        "thinking"
      ],
      "created_at": "2026-01-04T11:23:00Z",
      "display_name": "Claude Sonnet 5.5",
      "enabled": true,
      "healthy": true,
      "id": "model_01933b5a00007000800000000000001",
      "is_favorite": true,
      "model_id": "claude-sonnet-5-5",
      "model_vendor": "openai",
      "profile": {
        "modalities": {
          "input": [
            "text"
          ],
          "output": [
            "text"
          ]
        },
        "reasoning_effort": {
          "default": "none",
          "values": [
            {
              "value": "none"
            }
          ]
        },
        "speed": {
          "default": "flex",
          "values": [
            {
              "value": "flex"
            }
          ]
        },
        "verbosity": {
          "default": "low",
          "values": [
            {
              "value": "low"
            }
          ]
        }
      },
      "provider_id": "provider_01933b5a00007000800000000000001",
      "provider_name": "Anthropic",
      "service": "chat",
      "source": "manual",
      "updated_at": "2026-05-27T15:24:00Z",
      "allowed_actions": [
        {
          "method": "POST"
        }
      ]
    }
  ]
}
```