Skip to main content
GET
/
v1
/
evals
/
runs
/
{run_id}
/
agent-snapshots
List Agent Snapshots
curl --request GET \
  --url https://api.bland.ai/v1/evals/runs/{run_id}/agent-snapshots \
  --header 'authorization: <authorization>'
{
  "data": {
    "object": "list",
    "data": [
      {
        "id": "33333333-aaaa-bbbb-cccc-dddddddddddd",
        "org_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
        "eval_run_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
        "eval_agent_id": "11111111-aaaa-bbbb-cccc-dddddddddddd",
        "eval_agent_version_id": "22222222-aaaa-bbbb-cccc-dddddddddddd",
        "position": 0,
        "key": "resolution_quality",
        "name": "Resolution Quality",
        "modality": "text",
        "system_prompt_md": "You are an expert call quality analyst evaluating customer service interactions.",
        "prompt_md": "Did the agent fully resolve the customer's issue without requiring a callback?",
        "prompt_version": "v3.1.0",
        "levels": [
          {
            "level_key": "pass",
            "label": "Pass",
            "prompt_md": "The agent resolved the issue completely and the customer confirmed satisfaction.",
            "color": "#22c55e"
          },
          {
            "level_key": "partial",
            "label": "Partial",
            "prompt_md": "The agent addressed the issue but the customer expressed some remaining concern.",
            "color": "#f59e0b"
          },
          {
            "level_key": "fail",
            "label": "Fail",
            "prompt_md": "The issue was not resolved or the customer was transferred unnecessarily.",
            "color": "#ef4444"
          }
        ],
        "target_level_keys": ["pass"],
        "weight": 100,
        "created_at": "2026-05-27T10:00:00.000Z"
      }
    ],
    "has_more": false,
    "next_cursor": null
  },
  "errors": null
}

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.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
run_id
string
required
The ID of the eval run.
Snapshots freeze each agent’s prompt, levels, and targets at submission time, so historical results never change if you later edit the agent.

​
Response

​
object
string
Always "list".
​
data
array of objects
All agent snapshots for the run. Returns all snapshots in a single page.
​
has_more
boolean
Always false. All snapshots are returned in a single page.
​
next_cursor
null
Always null.
{
  "data": {
    "object": "list",
    "data": [
      {
        "id": "33333333-aaaa-bbbb-cccc-dddddddddddd",
        "org_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
        "eval_run_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
        "eval_agent_id": "11111111-aaaa-bbbb-cccc-dddddddddddd",
        "eval_agent_version_id": "22222222-aaaa-bbbb-cccc-dddddddddddd",
        "position": 0,
        "key": "resolution_quality",
        "name": "Resolution Quality",
        "modality": "text",
        "system_prompt_md": "You are an expert call quality analyst evaluating customer service interactions.",
        "prompt_md": "Did the agent fully resolve the customer's issue without requiring a callback?",
        "prompt_version": "v3.1.0",
        "levels": [
          {
            "level_key": "pass",
            "label": "Pass",
            "prompt_md": "The agent resolved the issue completely and the customer confirmed satisfaction.",
            "color": "#22c55e"
          },
          {
            "level_key": "partial",
            "label": "Partial",
            "prompt_md": "The agent addressed the issue but the customer expressed some remaining concern.",
            "color": "#f59e0b"
          },
          {
            "level_key": "fail",
            "label": "Fail",
            "prompt_md": "The issue was not resolved or the customer was transferred unnecessarily.",
            "color": "#ef4444"
          }
        ],
        "target_level_keys": ["pass"],
        "weight": 100,
        "created_at": "2026-05-27T10:00:00.000Z"
      }
    ],
    "has_more": false,
    "next_cursor": null
  },
  "errors": null
}