> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Eval Runs

> List eval runs in your organization, with optional filters.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Query Parameters

**eval\_agent\_id** `string`

Filter to runs that included this eval agent.

**workbench\_setup\_id** `string`

Filter to runs started from this workbench setup.

**status** `string`

Filter by run status. Possible values: `PENDING`, `QUEUED`, `RUNNING`, `COMPLETE`, `PARTIAL`, `FAILED`, `CANCELLED`.

**triggered\_by** `string`

Filter by how the run was triggered. Possible values: `manual`, `auto`, `backfill`.

**limit** `integer` (default: 25)

Number of results to return. Between 1 and 100.

**starting\_after** `string`

Cursor: return results after this object ID.

**ending\_before** `string`

Cursor: return results before this object ID. Cannot be combined with `starting_after`.

### Response

**object** `string`

Always `"list"`.

**data** `array of objects`

The list of eval run objects.

**EvalRun list item fields**

**id** `string`

Unique identifier for the eval run.

**status** `string`

Current status of the run. One of `PENDING`, `QUEUED`, `RUNNING`, `COMPLETE`, `PARTIAL`, `FAILED`, `CANCELLED`.

**triggered\_by** `string`

How the run was triggered. One of `manual`, `auto`, `backfill`.

**run\_mode** `string`

The scoring modality used. One of `text`, `audio`, `full`.

**resolved\_call\_count** `integer`

Number of calls resolved for the run.

**resolved\_agent\_count** `integer`

Number of eval agents resolved for the run.

**resolved\_atom\_count** `integer`

Total number of call-by-agent evaluations in the run.

**completed\_atom\_count** `integer`

Number of evaluations that have completed.

**summary** `object or null`

Aggregate scoring summary for the run, or `null` if not yet available.

**Summary fields**

**overall\_score\_mean** `number or null`

Mean overall score across all completed evaluations, normalized 0-100.

**text\_score\_mean** `number or null`

Mean text-modality score, normalized 0-100.

**audio\_score\_mean** `number or null`

Mean audio-modality score, normalized 0-100.

**successful\_call\_count** `integer`

Number of calls that were graded successfully.

**failed\_call\_count** `integer`

Number of calls that failed to grade.

**insufficient\_evidence\_count** `integer`

Number of evaluations where evidence was insufficient to produce a verdict.

**target\_match\_count** `integer`

Number of evaluations where the selected level matched a target level.

**pass\_threshold\_pct** `number or null`

The pass threshold percentage configured for the run, 0-100.

**overall\_pass** `boolean or null`

Whether the run met its pass threshold, or `null` if no threshold was set.

**billable\_cost\_usd** `number or null`

Billable cost for this run in USD.

**workbench\_setup\_id** `string or null`

The workbench setup the run was started from, if any.

**workbench\_setup\_version\_id** `string or null`

The pinned workbench setup version used, if any.

**metadata** `object`

Key-value metadata attached to the run.

**created\_at** `string`

ISO 8601 timestamp when the run was created.

**started\_at** `string or null`

ISO 8601 timestamp when the run started, or `null` if not yet started.

**completed\_at** `string or null`

ISO 8601 timestamp when the run completed, or `null` if not yet complete.

**has\_more** `boolean`

Whether more results exist beyond this page.

**next\_cursor** `string or null`

Cursor to use in `starting_after` to retrieve the next page, or `null` if there are no more results.

```json Response theme={null}
{
  "data": {
    "object": "list",
    "data": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "status": "COMPLETE",
        "triggered_by": "manual",
        "run_mode": "text",
        "resolved_call_count": 50,
        "resolved_agent_count": 3,
        "resolved_atom_count": 150,
        "completed_atom_count": 150,
        "summary": {
          "overall_score_mean": 82.4,
          "text_score_mean": 82.4,
          "audio_score_mean": null,
          "successful_call_count": 48,
          "failed_call_count": 2,
          "insufficient_evidence_count": 1,
          "target_match_count": 39,
          "pass_threshold_pct": 75,
          "overall_pass": true
        },
        "billable_cost_usd": 1.24,
        "workbench_setup_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "workbench_setup_version_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "metadata": {},
        "created_at": "2026-05-20T14:00:00.000Z",
        "started_at": "2026-05-20T14:00:05.000Z",
        "completed_at": "2026-05-20T14:03:42.000Z"
      },
      {
        "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
        "status": "RUNNING",
        "triggered_by": "auto",
        "run_mode": "full",
        "resolved_call_count": 100,
        "resolved_agent_count": 2,
        "resolved_atom_count": 200,
        "completed_atom_count": 87,
        "summary": null,
        "billable_cost_usd": null,
        "workbench_setup_id": null,
        "workbench_setup_version_id": null,
        "metadata": { "pipeline": "nightly" },
        "created_at": "2026-05-27T02:00:00.000Z",
        "started_at": "2026-05-27T02:00:08.000Z",
        "completed_at": null
      }
    ],
    "has_more": false,
    "next_cursor": null
  },
  "errors": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.