Skip to main content
GET
/
v1
/
agent-testing
/
tornado
/
{id}
/
status
Get Tornado Status
curl --request GET \
  --url https://api.bland.ai/v1/agent-testing/tornado/{id}/status \
  --header 'authorization: <authorization>'
{
  "session_id": "e1f2a3b4-5678-9cde-f012-3456789abcde",
  "status": "COMPLETED_ALL_PASSED",
  "current_iteration": 2,
  "max_iterations": 5,
  "total_scenarios": 3,
  "passed_scenarios": 3,
  "failed_scenarios": 0,
  "unfixable_count": 0,
  "unfixable_ids": [],
  "iterations": [
    {
      "iteration": 1,
      "batch_id": "b1c2d3e4-f567-890a-bcde-f01234567890",
      "started_at": "2026-04-14T10:15:01.000Z",
      "completed_at": "2026-04-14T10:17:45.000Z",
      "passed_ids": [
        "a1b2c3d4-5678-9abc-def0-1234567890ab"
      ],
      "failed_ids": [
        "f6a7b8c9-0abc-def1-2345-67890abcdef0",
        "d9e0f1a2-3456-789b-cdef-0123456789ab"
      ],
      "newly_unfixable_ids": [],
      "fix_plan": {
        "fixes": [
          {
            "id": "fix-001",
            "target_node": "de-escalation-handler",
            "description": "Add empathy statement before addressing complaint",
            "type": "prompt_edit"
          },
          {
            "id": "fix-002",
            "target_node": "transfer-logic",
            "description": "Lower transfer threshold from 3 failures to 2",
            "type": "config_change"
          }
        ],
        "priority_order": ["fix-001", "fix-002"]
      },
      "norm_prompt_excerpt": "When the caller expresses frustration, first acknowledge their feelings with an empathy statement..."
    },
    {
      "iteration": 2,
      "batch_id": "c2d3e4f5-6789-0abc-def0-123456789abc",
      "started_at": "2026-04-14T10:17:50.000Z",
      "completed_at": "2026-04-14T10:20:12.000Z",
      "passed_ids": [
        "a1b2c3d4-5678-9abc-def0-1234567890ab",
        "f6a7b8c9-0abc-def1-2345-67890abcdef0",
        "d9e0f1a2-3456-789b-cdef-0123456789ab"
      ],
      "failed_ids": [],
      "newly_unfixable_ids": [],
      "fix_plan": {
        "fixes": [],
        "priority_order": []
      },
      "norm_prompt_excerpt": null
    }
  ],
  "elapsed_ms": 312000,
  "timeout_ms": 900000,
  "forked_version": 4
}

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

​
id
string
required
The tornado session ID.

​
Response

​
session_id
string
The unique identifier for the tornado session.
​
status
string
Current status of the session. One of RUNNING, COMPLETED_ALL_PASSED, COMPLETED_PARTIAL, TIMEOUT, STUCK, CANCELLED, or ERROR.
​
current_iteration
integer
The current or final iteration number.
​
max_iterations
integer
The maximum number of fix iterations configured.
​
total_scenarios
integer
Total number of scenarios being tested.
​
passed_scenarios
integer
Number of scenarios currently passing.
​
failed_scenarios
integer
Number of scenarios currently failing.
​
unfixable_count
integer
Number of scenarios that failed across multiple iterations with the same root cause.
​
unfixable_ids
array of strings
IDs of scenarios deemed unfixable.
​
iterations
array
Array of iteration objects describing each fix cycle.
​
elapsed_ms
integer
Time elapsed since the session started in milliseconds.
​
timeout_ms
integer
The timeout configured for this session in milliseconds.
​
forked_version
integer
The pathway version created from the applied fixes.
{
  "session_id": "e1f2a3b4-5678-9cde-f012-3456789abcde",
  "status": "COMPLETED_ALL_PASSED",
  "current_iteration": 2,
  "max_iterations": 5,
  "total_scenarios": 3,
  "passed_scenarios": 3,
  "failed_scenarios": 0,
  "unfixable_count": 0,
  "unfixable_ids": [],
  "iterations": [
    {
      "iteration": 1,
      "batch_id": "b1c2d3e4-f567-890a-bcde-f01234567890",
      "started_at": "2026-04-14T10:15:01.000Z",
      "completed_at": "2026-04-14T10:17:45.000Z",
      "passed_ids": [
        "a1b2c3d4-5678-9abc-def0-1234567890ab"
      ],
      "failed_ids": [
        "f6a7b8c9-0abc-def1-2345-67890abcdef0",
        "d9e0f1a2-3456-789b-cdef-0123456789ab"
      ],
      "newly_unfixable_ids": [],
      "fix_plan": {
        "fixes": [
          {
            "id": "fix-001",
            "target_node": "de-escalation-handler",
            "description": "Add empathy statement before addressing complaint",
            "type": "prompt_edit"
          },
          {
            "id": "fix-002",
            "target_node": "transfer-logic",
            "description": "Lower transfer threshold from 3 failures to 2",
            "type": "config_change"
          }
        ],
        "priority_order": ["fix-001", "fix-002"]
      },
      "norm_prompt_excerpt": "When the caller expresses frustration, first acknowledge their feelings with an empathy statement..."
    },
    {
      "iteration": 2,
      "batch_id": "c2d3e4f5-6789-0abc-def0-123456789abc",
      "started_at": "2026-04-14T10:17:50.000Z",
      "completed_at": "2026-04-14T10:20:12.000Z",
      "passed_ids": [
        "a1b2c3d4-5678-9abc-def0-1234567890ab",
        "f6a7b8c9-0abc-def1-2345-67890abcdef0",
        "d9e0f1a2-3456-789b-cdef-0123456789ab"
      ],
      "failed_ids": [],
      "newly_unfixable_ids": [],
      "fix_plan": {
        "fixes": [],
        "priority_order": []
      },
      "norm_prompt_excerpt": null
    }
  ],
  "elapsed_ms": 312000,
  "timeout_ms": 900000,
  "forked_version": 4
}