# Outbound metrics

> Returns outbound call metrics: dial funnel (dials → connected → conversations → conversions), time series, heatmap, leaderboard, and time spent metrics.

`POST /v2/api/analytics/outbound`

<Note>
**Required scope:** `CONVERSATIONS_READ`
</Note>

## Extend parameter

Use `extend=items` with a `stage` to include the actual list of outbound calls behind the funnel numbers in the response.

| Value | Requires | Effect |
|-------|----------|--------|
| `items` | `stage` | Includes a paginated `items` field with the calls for the specified funnel stage |

### Stages

| Stage | Calls included |
|-------|----------------|
| `DIAL` | All outbound dials |
| `CONNECTED` | Calls where the recipient picked up |
| `CONVERSATION` | Connected calls longer than 1 minute |
| `CONVERSION` | Calls tagged with one of the specified `tags` |

### Example with drilldown

```json
{
  "date": { "from": "2026-04-14", "to": "2026-04-21" },
  "tags": ["meeting_booked"],
  "granularity": "DAY",
  "extend": "items",
  "stage": "CONVERSION",
  "page": 1,
  "size": 20
}
```

The response includes the full funnel metrics **plus** an `items` field with the paginated call list for the requested stage.

Passing `extend=items` without `stage` returns a `400` error with code `MISSING_PARAMETER`.
