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

# Get Eval Run

> Fetch one eval run and its current status and summary.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**run\_id** `string` *required*

The ID of the eval run to retrieve.

### Response

**id** `string`

Unique identifier for the eval run.

**org\_id** `string`

The organization that owns this run.

**status** `string`

Current status. 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. One of `text`, `audio`, `full`.

**submitted\_call\_ids** `array of string`

The call IDs submitted for scoring.

**submitted\_attached\_agents** `array of objects`

The agent attachments submitted with the run. Each object contains `eval_agent_id`, `eval_agent_version_id`, `weight`, and `target_level_keys`.

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

The associated workbench setup, if any.

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

The pinned workbench setup version, if any.

**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 call-by-agent evaluations in the run.

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

Number of evaluations completed so far.

**summary** `object or null`

Aggregate scoring summary, 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 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 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, or `null` if not yet finalized.

**error\_code** `string or null`

Error code if the run failed, otherwise `null`.

**error\_message** `string or null`

Human-readable error message if the run failed, otherwise `null`.

**workflow\_id** `string or null`

Internal workflow identifier, if applicable.

**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.

```json Response theme={null}
{
  "data": {
    "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "org_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
    "status": "COMPLETE",
    "triggered_by": "manual",
    "run_mode": "text",
    "submitted_call_ids": [
      "a1b2c3d4-0000-0000-0000-000000000001",
      "a1b2c3d4-0000-0000-0000-000000000002"
    ],
    "submitted_attached_agents": [
      {
        "eval_agent_id": "11111111-aaaa-bbbb-cccc-dddddddddddd",
        "eval_agent_version_id": "22222222-aaaa-bbbb-cccc-dddddddddddd",
        "weight": 100,
        "target_level_keys": ["pass"]
      }
    ],
    "workbench_setup_id": null,
    "workbench_setup_version_id": null,
    "resolved_call_count": 2,
    "resolved_agent_count": 1,
    "resolved_atom_count": 2,
    "completed_atom_count": 2,
    "summary": {
      "overall_score_mean": 91.5,
      "text_score_mean": 91.5,
      "audio_score_mean": null,
      "successful_call_count": 2,
      "failed_call_count": 0,
      "insufficient_evidence_count": 0,
      "target_match_count": 2,
      "pass_threshold_pct": 80,
      "overall_pass": true
    },
    "billable_cost_usd": 0.04,
    "error_code": null,
    "error_message": null,
    "workflow_id": null,
    "metadata": {},
    "created_at": "2026-05-27T10:00:00.000Z",
    "started_at": "2026-05-27T10:00:05.000Z",
    "completed_at": "2026-05-27T10:01:12.000Z"
  },
  "errors": null
}
```


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