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

> List an agent's check runs for one environment.

### Overview

Returns the agent's check runs for one environment, newest first, including runs still in flight. Use it for history or to see which run is active. To poll a single run, use [Get Check Run](https://docs.bland.ai/api-v2/get/agents-id-check-runs-run-id.md).

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**agent\_id** `string` *required*

The agent's unique identifier.

### Query Parameters

**env** `string` (default: production)

The environment to list runs for: `staging` or `production`. Any other value falls back to `production`.

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

Maximum number of runs to return. Minimum `1`, maximum `100`. Values outside that range are clamped.

### Response

**data** `array`

Array of check run objects, newest first.

**check run object**

**id** `string`

Unique identifier for the check run.

**agent\_id** `string`

The agent the run belongs to.

**env\_type** `string`

The environment whose checks were run: `staging` or `production`.

**agent\_version\_id** `string`

The candidate version the run scored.

**semver** `string | null`

The candidate's published version number, or `null` if it has never been published.

**version\_name** `string | null`

The candidate's saved name, or `null` if it has none.

**status** `string`

`PENDING`, `RUNNING`, `PASSED`, `FAILED`, `ERROR`, or `CANCELLED`. The last four are terminal.

**judge\_names** `array`

Display names of the judges frozen into the run when it started.

**scenario\_count** `integer`

Number of scenarios the run drove conversations from.

**simulations\_count** `integer`

Conversations generated per scenario.

**overall\_passed** `boolean | null`

`true` when the run `PASSED`, `false` when it `FAILED`, `null` otherwise.

**verdicts** `array | null`

Per-judge results, or `null` until the run completes. Each has `eval_agent_id`, `eval_agent_version_id`, `name`, `required`, `target_level_keys`, `match_rate`, `score`, and `passed`. See [Get Check Run](https://docs.bland.ai/api-v2/get/agents-id-check-runs-run-id.md) for field details.

**simulation\_set\_id** `string | null`

ID of the generated conversation set. `null` until generation starts.

**eval\_run\_id** `string | null`

ID of the scoring run. `null` until scoring starts.

**error\_message** `string | null`

Why the run ended in `ERROR`, or `null`.

**triggered\_by** `string | null`

ID of the user who started the run, or `null` when started with an org-level key.

**created\_at** `string`

ISO 8601 timestamp the run was created.

**started\_at** `string | null`

When scoring began. `null` while `PENDING`.

**completed\_at** `string | null`

When the run reached a terminal status. `null` while in flight.

**errors** `null | array`

`null` on success, or a list of error objects if the request failed.

```json Response theme={null}
{
  "data": [
    {
      "id": "ac5df482-7883-412b-b8a8-bb6496d500ec",
      "agent_id": "35675d2f-3e9d-4d61-a43c-4cf4db5bddc9",
      "env_type": "staging",
      "agent_version_id": "dacfbe0a-bc77-4d0c-9c27-b969ed928dcd",
      "semver": null,
      "version_name": "Add callback offer",
      "status": "RUNNING",
      "judge_names": ["Resolution quality"],
      "scenario_count": 2,
      "simulations_count": 5,
      "overall_passed": null,
      "verdicts": null,
      "simulation_set_id": "c4f2e783-688c-41b0-ae2f-b77773805771",
      "eval_run_id": null,
      "error_message": null,
      "triggered_by": "4bf4c1d6-b1f0-4a29-809f-3fcee3709a07",
      "created_at": "2026-09-10T18:41:02.774Z",
      "started_at": "2026-09-10T18:41:05.309Z",
      "completed_at": null
    },
    {
      "id": "f0024822-5696-4392-929b-88a88a966e71",
      "agent_id": "35675d2f-3e9d-4d61-a43c-4cf4db5bddc9",
      "env_type": "staging",
      "agent_version_id": "6b2027df-5727-4feb-8215-2d57a1cfe82b",
      "semver": "1.3.0",
      "version_name": null,
      "status": "PASSED",
      "judge_names": ["Resolution quality"],
      "scenario_count": 2,
      "simulations_count": 5,
      "overall_passed": true,
      "verdicts": [
        {
          "eval_agent_id": "bcb07d72-36f0-49db-8fdf-f922d7b0a736",
          "eval_agent_version_id": "0754e124-3915-4666-bd22-aa7f5f6d06cb",
          "name": "Resolution quality",
          "required": true,
          "target_level_keys": ["good", "excellent"],
          "match_rate": 0.9,
          "score": 84.6,
          "passed": true
        }
      ],
      "simulation_set_id": "698e65a5-dd49-448f-8db9-6c5e7e667bec",
      "eval_run_id": "b1aa992f-3503-42b0-b3f5-6c376d037090",
      "error_message": null,
      "triggered_by": null,
      "created_at": "2026-09-09T11:15:48.020Z",
      "started_at": "2026-09-09T11:15:50.611Z",
      "completed_at": "2026-09-09T11:27:13.488Z"
    }
  ],
  "errors": null
}
```

```json Not Found theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Agent not found"
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


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