Skip to main content
GET
/
v1
/
agent-testing
/
scenarios
List Test Scenarios
curl --request GET \
  --url https://api.bland.ai/v1/agent-testing/scenarios \
  --header 'authorization: <authorization>'
{
  "scenarios": [
    {
      "id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
      "org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
      "pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
      "persona_id": null,
      "name": "Angry Caller Test",
      "description": "Tests de-escalation handling",
      "category": "ANGRY_CALLER",
      "scenario_type": "AGENT",
      "tester_persona_prompt": "You are a frustrated customer...",
      "tester_persona_name": "Frustrated Customer",
      "max_turns": 15,
      "bland_tone_enabled": true,
      "is_required_for_promotion": false,
      "enabled": true,
      "assertions": [
        {
          "id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
          "type": "LLM_JUDGE",
          "name": "De-escalation",
          "config": {
            "prompt": "Did the agent successfully de-escalate the situation?",
            "output_type": "score",
            "threshold": 0.7
          },
          "is_required": true,
          "weight": 1.5,
          "order": 0
        }
      ],
      "most_recent_run": {
        "id": "e5f6a7b8-9abc-def0-1234-567890abcdef",
        "status": "PASSED",
        "score": 0.85,
        "completed_at": "2026-04-13T18:30:00.000Z"
      },
      "created_at": "2026-04-10T12:00:00.000Z",
      "updated_at": "2026-04-13T18:30:00.000Z"
    },
    {
      "id": "f6a7b8c9-0abc-def1-2345-67890abcdef0",
      "org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
      "pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
      "persona_id": null,
      "name": "Happy Path - Booking",
      "description": "Tests the standard booking flow",
      "category": "HAPPY_PATH",
      "scenario_type": "AGENT",
      "tester_persona_prompt": "You want to book an appointment for next Tuesday at 2pm.",
      "tester_persona_name": "Polite Customer",
      "max_turns": 20,
      "bland_tone_enabled": false,
      "is_required_for_promotion": true,
      "enabled": true,
      "assertions": [
        {
          "id": "a7b8c9d0-1abc-ef23-4567-890abcdef012",
          "type": "NODE_REACHED",
          "name": "Reached Booking Confirmation",
          "config": {
            "node_id": "booking-confirmation-node"
          },
          "is_required": true,
          "weight": 1.0,
          "order": 0
        }
      ],
      "most_recent_run": null,
      "created_at": "2026-04-12T09:00:00.000Z",
      "updated_at": "2026-04-12T09:00:00.000Z"
    }
  ]
}

Headers

authorization
string
required
Your API key for authentication.

Query Parameters

pathway_id
string
Filter by pathway ID.
persona_id
string
Filter by persona ID.
category
string
Filter by scenario category.
enabled
string
Filter by enabled status. Pass "true" or "false".

Response

scenarios
array
Array of scenario objects, each including assertions and the most recent run.
{
  "scenarios": [
    {
      "id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
      "org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
      "pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
      "persona_id": null,
      "name": "Angry Caller Test",
      "description": "Tests de-escalation handling",
      "category": "ANGRY_CALLER",
      "scenario_type": "AGENT",
      "tester_persona_prompt": "You are a frustrated customer...",
      "tester_persona_name": "Frustrated Customer",
      "max_turns": 15,
      "bland_tone_enabled": true,
      "is_required_for_promotion": false,
      "enabled": true,
      "assertions": [
        {
          "id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
          "type": "LLM_JUDGE",
          "name": "De-escalation",
          "config": {
            "prompt": "Did the agent successfully de-escalate the situation?",
            "output_type": "score",
            "threshold": 0.7
          },
          "is_required": true,
          "weight": 1.5,
          "order": 0
        }
      ],
      "most_recent_run": {
        "id": "e5f6a7b8-9abc-def0-1234-567890abcdef",
        "status": "PASSED",
        "score": 0.85,
        "completed_at": "2026-04-13T18:30:00.000Z"
      },
      "created_at": "2026-04-10T12:00:00.000Z",
      "updated_at": "2026-04-13T18:30:00.000Z"
    },
    {
      "id": "f6a7b8c9-0abc-def1-2345-67890abcdef0",
      "org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
      "pathway_id": "c3d4e5f6-789a-bcde-f012-34567890abcd",
      "persona_id": null,
      "name": "Happy Path - Booking",
      "description": "Tests the standard booking flow",
      "category": "HAPPY_PATH",
      "scenario_type": "AGENT",
      "tester_persona_prompt": "You want to book an appointment for next Tuesday at 2pm.",
      "tester_persona_name": "Polite Customer",
      "max_turns": 20,
      "bland_tone_enabled": false,
      "is_required_for_promotion": true,
      "enabled": true,
      "assertions": [
        {
          "id": "a7b8c9d0-1abc-ef23-4567-890abcdef012",
          "type": "NODE_REACHED",
          "name": "Reached Booking Confirmation",
          "config": {
            "node_id": "booking-confirmation-node"
          },
          "is_required": true,
          "weight": 1.0,
          "order": 0
        }
      ],
      "most_recent_run": null,
      "created_at": "2026-04-12T09:00:00.000Z",
      "updated_at": "2026-04-12T09:00:00.000Z"
    }
  ]
}