# List evals.

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

GET

/v1/evals

Select code samplecURL (shell:curl)

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

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

## Parameters

### Query Parameters

**search**

string

Case-insensitive name filter.

**include\_archived**

boolean

Include archived evals.

## Responses

### 200

Success

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>

An eval: a named collection of test cases for an agent.

object

**archived\_at**

When the eval was archived, if archived.

string | null format: date-time

**case\_count**

Number of cases.

integer format: int64

**created\_at**

required

When the eval was created.

string format: date-time

**deleted\_at**

When the eval was deleted, if deleted.

string | null format: date-time

**description**

Optional description.

string | null

**id**

required

External identifier (eval\_<32-hex>). Shown as “id” in API.

string

**last\_run**

One of:

* object

  Last run summary (if any).

  object

  **created\_at**

  required

  When the run was created.

  string format: date-time

  **id**

  required

  Eval run identifier.

  string

  **status**

  required

  Run lifecycle status.

  string

  Allowed values: pending running completed failed cancelled

  **summary**

  One of:

  * object

    Aggregate metrics, if the run has completed.

    object

    **avg\_latency\_ms**

    required

    Mean case latency in milliseconds.

    integer format: int64

    **avg\_score**

    required

    Mean score across cases, 0.0 to 1.0.

    number format: double

    **avg\_turns**

    required

    Mean agent turns per case.

    number format: double

    **errored**

    required

    Number of cases that errored.

    integer format: int32

    **failed**

    required

    Number of cases that failed.

    integer format: int32

    **pass\_rate**

    required

    Fraction of cases that passed, 0.0 to 1.0.

    number format: double

    **passed**

    required

    Number of cases that passed.

    integer format: int32

    **total**

    required

    Total number of cases in the run.

    integer format: int32

    **total\_input\_tokens**

    required

    Total input tokens across cases.

    integer format: int64

    **total\_output\_tokens**

    required

    Total output tokens across cases.

    integer format: int64

  * null

    null

* null

  Aggregate metrics, if the run has completed.

  object

  **avg\_latency\_ms**

  required

  Mean case latency in milliseconds.

  integer format: int64

  **avg\_score**

  required

  Mean score across cases, 0.0 to 1.0.

  number format: double

  **avg\_turns**

  required

  Mean agent turns per case.

  number format: double

  **errored**

  required

  Number of cases that errored.

  integer format: int32

  **failed**

  required

  Number of cases that failed.

  integer format: int32

  **pass\_rate**

  required

  Fraction of cases that passed, 0.0 to 1.0.

  number format: double

  **passed**

  required

  Number of cases that passed.

  integer format: int32

  **total**

  required

  Total number of cases in the run.

  integer format: int32

  **total\_input\_tokens**

  required

  Total input tokens across cases.

  integer format: int64

  **total\_output\_tokens**

  required

  Total output tokens across cases.

  integer format: int64

* object

  null

* null

  null

**model\_override**

Optional default model override for runs.

string | null

**name**

required

Display name.

string

**status**

required

Lifecycle status.

string

Allowed values: active archived deleted

**tags**

Organization tags.

Array\<string>

**target**

One of:

* object

  One of:

  * object

    Session creation parameters (mirrors CreateSessionRequest).

    object

    **agent\_id**

    Agent to work in this session.

    string | null

    **harness\_id**

    Harness for the session. If omitted, org default harness is used.

    string | null

    **harness\_name**

    Addressable harness name (alternative to harness\_id).

    string | null

    **max\_iterations**

    Max LLM iterations per turn.

    integer | null

    **model\_id**

    LLM model override.

    string | null

    **system\_prompt**

    System prompt override (prepended to agent prompt).

    string | null

    **type**

    required

    string

    Allowed values: session

  * object

    Reference to a deployed app.

    object

    **app\_id**

    required

    string

    **type**

    required

    string

    Allowed values: app

  * object

    Label-only target for externally-executed runs (e.g. imported from Mira).

    Carries provider/model labels and opaque params instead of session setup: external runs are ingested already-complete, so everruns never builds a session from this. Mirrors a provider-agnostic `(provider, model)` pair.

    object

    **model**

    required

    string

    **params**

    **provider**

    required

    string

    **type**

    required

    string

    Allowed values: external

* null

  Session creation parameters (mirrors CreateSessionRequest).

  object

  **agent\_id**

  Agent to work in this session.

  string | null

  **harness\_id**

  Harness for the session. If omitted, org default harness is used.

  string | null

  **harness\_name**

  Addressable harness name (alternative to harness\_id).

  string | null

  **max\_iterations**

  Max LLM iterations per turn.

  integer | null

  **model\_id**

  LLM model override.

  string | null

  **system\_prompt**

  System prompt override (prepended to agent prompt).

  string | null

  **type**

  required

  string

  Allowed values: session

* object

  Reference to a deployed app.

  object

  **app\_id**

  required

  string

  **type**

  required

  string

  Allowed values: app

* object

  Label-only target for externally-executed runs (e.g. imported from Mira).

  Carries provider/model labels and opaque params instead of session setup: external runs are ingested already-complete, so everruns never builds a session from this. Mirrors a provider-agnostic `(provider, model)` pair.

  object

  **model**

  required

  string

  **params**

  **provider**

  required

  string

  **type**

  required

  string

  Allowed values: external

* object

  null

**updated\_at**

required

When the eval was last updated.

string format: date-time

##### Example

```json
{
  "data": [
    {
      "archived_at": "2026-01-15T10:30:00Z",
      "case_count": 12,
      "created_at": "2026-01-15T10:30:00Z",
      "deleted_at": "2026-01-15T10:30:00Z",
      "description": "Regression suite for the support agent",
      "id": "eval_01933b5a000070008000000000000001",
      "last_run": {
        "created_at": "2026-01-15T10:30:00Z",
        "status": "pending",
        "summary": {
          "avg_latency_ms": 8450,
          "avg_score": 0.85,
          "avg_turns": 3.2,
          "errored": 1,
          "failed": 2,
          "pass_rate": 0.75,
          "passed": 9,
          "total": 12,
          "total_input_tokens": 14400,
          "total_output_tokens": 10200
        }
      },
      "model_override": "gpt-5.1",
      "name": "Support agent regression",
      "status": "active",
      "tags": [
        "regression",
        "nightly"
      ],
      "target": {
        "type": "session"
      },
      "updated_at": "2026-01-15T10:30:00Z"
    }
  ]
}
```