> ## 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.

# Get Enhanced Analytics

> Get enhanced testing analytics including node failure heatmap, weakest link, trend analysis, and Sankey flow data.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**pathwayId** `string` *required*

The pathway ID.

### Query Parameters

**days** `integer` (default: 30)

Number of days to look back. Maximum value is 365.

### Response

**total\_runs** `integer`

Total number of test runs in the time window.

**passed** `integer`

Number of test runs that passed.

**failed** `integer`

Number of test runs that failed.

**pass\_rate** `number`

Pass rate as a decimal from 0 to 1.

**avg\_score** `number`

Average score across all runs, from 0 to 1.

**health\_score** `number`

Overall health score for the pathway, from 0 to 1. Combines pass rate, trend direction, and reliability.

**reliability\_score** `number`

Reliability score measuring consistency of results over time, from 0 to 1.

**trend** `object`

Trend analysis for the time window.

**trend object**

**weekly** `string`

Weekly trend direction. One of: `improving`, `declining`, `stable`.

**daily\_pass\_rates** `array`

Daily pass rate data points.

**daily pass rate object**

**date** `string`

The date in ISO 8601 format.

**rate** `number`

Pass rate for that date, from 0 to 1.

**count** `integer`

Number of runs on that date.

**node\_failure\_heatmap** `array`

Failure data per node for building a heatmap visualization.

**node failure object**

**node\_id** `string`

The node ID.

**node\_name** `string`

The display name of the node.

**failure\_count** `integer`

Number of times a test failed at or through this node.

**total\_traversals** `integer`

Total number of times this node was traversed across all runs.

**failure\_rate** `number`

Failure rate for this node, from 0 to 1.

**weakest\_link** `object`

The node with the highest failure rate, or `null` if no failures exist.

**weakest link object**

**node\_id** `string`

The node ID.

**node\_name** `string`

The display name of the node.

**failure\_rate** `number`

Failure rate for this node, from 0 to 1.

**sankey\_data** `object`

Flow data for building a Sankey diagram of test run traversals.

**sankey data object**

**nodes** `array`

Array of nodes in the flow.

**sankey node object**

**id** `string`

The node ID.

**name** `string`

The display name of the node.

**type** `string`

The node type (e.g., `Default`, `Transfer`, `End Call`).

**category** `string`

The node category for coloring (e.g., `start`, `middle`, `end`, `error`).

**links** `array`

Array of links (edges) between nodes.

**sankey link object**

**source** `string`

The source node ID.

**target** `string`

The target node ID.

**value** `integer`

Total number of traversals along this link.

**pass\_count** `integer`

Number of traversals from passing runs.

**fail\_count** `integer`

Number of traversals from failing runs.

```json Response theme={null}
{
  "total_runs": 124,
  "passed": 98,
  "failed": 26,
  "pass_rate": 0.7903,
  "avg_score": 0.82,
  "health_score": 0.76,
  "reliability_score": 0.85,
  "trend": {
    "weekly": "improving",
    "daily_pass_rates": [
      { "date": "2026-04-12", "rate": 0.75, "count": 8 },
      { "date": "2026-04-13", "rate": 0.88, "count": 16 },
      { "date": "2026-04-14", "rate": 0.90, "count": 10 }
    ]
  },
  "node_failure_heatmap": [
    {
      "node_id": "node_8f3a2b1c",
      "node_name": "Escalation Handler",
      "failure_count": 14,
      "total_traversals": 38,
      "failure_rate": 0.3684
    },
    {
      "node_id": "node_4d7e9f0a",
      "node_name": "Appointment Booking",
      "failure_count": 8,
      "total_traversals": 72,
      "failure_rate": 0.1111
    },
    {
      "node_id": "node_1a2b3c4d",
      "node_name": "Greeting",
      "failure_count": 2,
      "total_traversals": 124,
      "failure_rate": 0.0161
    },
    {
      "node_id": "node_5e6f7a8b",
      "node_name": "Collect Info",
      "failure_count": 2,
      "total_traversals": 110,
      "failure_rate": 0.0182
    }
  ],
  "weakest_link": {
    "node_id": "node_8f3a2b1c",
    "node_name": "Escalation Handler",
    "failure_rate": 0.3684
  },
  "sankey_data": {
    "nodes": [
      { "id": "node_1a2b3c4d", "name": "Greeting", "type": "Default", "category": "start" },
      { "id": "node_5e6f7a8b", "name": "Collect Info", "type": "Default", "category": "middle" },
      { "id": "node_4d7e9f0a", "name": "Appointment Booking", "type": "Default", "category": "middle" },
      { "id": "node_8f3a2b1c", "name": "Escalation Handler", "type": "Transfer", "category": "middle" },
      { "id": "node_9c0d1e2f", "name": "Confirmation", "type": "Default", "category": "middle" },
      { "id": "node_end_001", "name": "End Call", "type": "End Call", "category": "end" }
    ],
    "links": [
      { "source": "node_1a2b3c4d", "target": "node_5e6f7a8b", "value": 110, "pass_count": 96, "fail_count": 14 },
      { "source": "node_5e6f7a8b", "target": "node_4d7e9f0a", "value": 72, "pass_count": 64, "fail_count": 8 },
      { "source": "node_5e6f7a8b", "target": "node_8f3a2b1c", "value": 38, "pass_count": 24, "fail_count": 14 },
      { "source": "node_4d7e9f0a", "target": "node_9c0d1e2f", "value": 64, "pass_count": 64, "fail_count": 0 },
      { "source": "node_9c0d1e2f", "target": "node_end_001", "value": 64, "pass_count": 64, "fail_count": 0 },
      { "source": "node_8f3a2b1c", "target": "node_end_001", "value": 24, "pass_count": 24, "fail_count": 0 }
    ]
  }
}
```

***

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.