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

> List an environment's deployment history, newest first.

### Overview

Every publish, promote, and rollback appends a deployment to the target environment's history. This endpoint returns that history for one environment, newest first, with the latest check run recorded for each deployed version. Use `is_rollback_eligible` to find valid targets for [Roll Back Agent](https://docs.bland.ai/api-v2/post/agents-id-rollback.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)

Environment to list: `dev`, `staging`, or `production`. Any other value falls back to `production`.

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

Maximum number of deployments to return. Minimum `1`, maximum `200`. Values outside that range are clamped; a non-numeric value falls back to `50`.

### Response

**data** `array`

Deployments for the requested environment, newest first.

**deployment object**

**id** `string`

Unique identifier for the deployment.

**env\_type** `string`

The environment this deployment was made to. Matches the `env` query parameter.

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

ID of the version that was deployed.

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

The version's saved name, or `null` if it was never named.

**semver** `string`

The version number recorded on this deployment. Promotes and rollbacks re-record the version's original number rather than minting a new one.

**deployed\_by** `string | null`

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

**deployed\_at** `string`

ISO 8601 timestamp of the deployment.

**check\_run** `object | null`

The newest check run that scored this deployment's version, regardless of the environment the run targeted. `null` if the version has never been checked. See `data[].check_run` below.

**is\_rollback\_eligible** `boolean`

`true` for `production` deployments whose version is not the current production pin. Always `false` for `dev` and `staging`.

**data\[].check\_run** `object | null`

The check run attached to a deployment.

**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 the run was started for: `staging` or `production`.

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

The version the run scored.

**semver** `string | null`

The scored version's number, or `null` if it had not been published when the run was read.

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

The scored version's saved name, or `null`.

**status** `string`

One of `PENDING`, `RUNNING`, `PASSED`, `FAILED`, `ERROR`, `CANCELLED`.

**judge\_names** `string[]`

Display names of the judges configured when the run started.

**scenario\_count** `integer`

Number of test scenarios in the run.

**simulations\_count** `integer`

Conversations generated per scenario.

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

`true` when every required judge passed, `false` when one failed, `null` while the run has no verdict.

**verdicts** `array | null`

One entry per judge once the run finishes, otherwise `null`. Each has `eval_agent_id`, `eval_agent_version_id`, `name`, `required`, `target_level_keys` (string array, empty for pass/fail judges), `match_rate` (number or `null`), `score` (0 to 100, or `null`), and `passed` (boolean or `null`).

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

ID of the simulated conversation set, once created.

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

ID of the evaluation run that scored the simulations, once started.

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

Failure detail when `status` is `ERROR`.

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

ID of the user who started the run, or `null`.

**created\_at** `string`

ISO 8601 timestamp the run was created.

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

ISO 8601 timestamp the run began executing, or `null`.

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

ISO 8601 timestamp the run reached a terminal status, or `null`.

**errors** `null | array`

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

```json Response theme={null}
{
  "data": [
    {
      "id": "e787c15f-abe6-409d-a685-1b007aad977d",
      "env_type": "production",
      "agent_version_id": "6cd4ce35-a4d2-4d13-a708-2a05f86ed3d8",
      "version_name": "Holiday hours",
      "semver": "1.3.2",
      "deployed_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
      "deployed_at": "2026-09-10T18:42:11.904Z",
      "check_run": {
        "id": "16a5fe15-9458-4237-b884-69ce44413aae",
        "agent_id": "449bbc38-188a-4533-b73a-ebf1debdf535",
        "env_type": "staging",
        "agent_version_id": "6cd4ce35-a4d2-4d13-a708-2a05f86ed3d8",
        "semver": "1.3.2",
        "version_name": "Holiday hours",
        "status": "PASSED",
        "judge_names": [
          "Greeting quality"
        ],
        "scenario_count": 3,
        "simulations_count": 2,
        "overall_passed": true,
        "verdicts": [
          {
            "eval_agent_id": "de2d68ac-cfc6-4c40-8b1a-d6e541133f3c",
            "eval_agent_version_id": "e112f640-71be-46ca-8269-746abec3bcde",
            "name": "Greeting quality",
            "required": true,
            "target_level_keys": [],
            "match_rate": 1,
            "score": 88,
            "passed": true
          }
        ],
        "simulation_set_id": "0cb85a21-bd7d-4a73-ace4-738507fb36a0",
        "eval_run_id": "968c3972-ecca-4878-acd5-273a21853d5b",
        "error_message": null,
        "triggered_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
        "created_at": "2026-09-10T18:30:02.117Z",
        "started_at": "2026-09-10T18:30:03.540Z",
        "completed_at": "2026-09-10T18:36:48.221Z"
      },
      "is_rollback_eligible": false
    },
    {
      "id": "579eca61-40fa-433b-8066-809927758313",
      "env_type": "production",
      "agent_version_id": "0f5adeb8-94a2-4cc3-8e6e-015178f994b7",
      "version_name": null,
      "semver": "1.3.1",
      "deployed_by": "f4cfacd2-d5b9-4498-ace1-8868e5b05b49",
      "deployed_at": "2026-09-03T15:07:39.318Z",
      "check_run": null,
      "is_rollback_eligible": true
    }
  ],
  "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.