# list_model_profiles

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

GET

/v1/model-profiles

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/model-profiles';
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/model-profiles
```

* Production APIapp.everruns.com/api/v1/model-profiles

List curated and account-scoped profiles visible to the caller, optionally filtered by service or provider.

## 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

Return only profiles for this service.

**provider\_id**

string | null

Prefixed provider account ID used to restrict available profiles.

## Responses

### 200

Authorized model profiles

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\<object>

Read-only model behavior, independent from the credentials of a serving account.

object

**key**

required

Stable profile identity, including a vendor or custom-account namespace.

string

**profile**

required

Capabilities, decision semantics, limits and pricing for this model.

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

**service**

required

Model service described by the profile.

string

Allowed values: chat decisions embeddings realtime images rerank

**source**

required

Profile origin: curated, discovered, predefined or manual.

string

**vendor**

One of:

* string

  Model developer, when known; this may differ from the serving provider.

  string

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

* null

  null

##### Example

```json
{
  "data": [
    {
      "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"
            }
          ]
        }
      },
      "service": "chat",
      "vendor": "openai"
    }
  ]
}
```