---
title: "Engagement Funnel For Agent"
method: GET
path: "/voice/analytics/funnel/agent"
tags: ["Voice Agent Analytics"]
---

# Engagement Funnel For Agent

`GET /voice/analytics/funnel/agent`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/voice/analytics/funnel/agent`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

### Engagement Funnel For Agent

Buckets one agent's conversations by transcript turn count (bounce/brief/engaged/deep), each with average duration and sentiment split. Defaults to the last 30 days if since is omitted; since older than 365 days is floored to 365 days ago. The response payload sits directly on data, not nested under a named key.

## Query parameters

- `agentId` string, required
- `since` string

## Response `200`

OK

- object
  - `status` 'success'
  - `data` object
    - `buckets` object[]: Always 4 buckets, in order: Bounce (0-1 turns), Brief (2-5), Engaged (6-15), Deep (16+).
      - `label` string
      - `minMessages` integer
      - `maxMessages` integer, nullable
      - `count` integer
      - `percentage` integer
      - `avgDurationSeconds` number
      - `sentimentBreakdown` object
        - `positive` integer
        - `neutral` integer
        - `negative` integer
        - `unanalyzed` integer
    - `totalConversations` integer
    - `since` string, date-time

## Other responses

- `400`: Invalid since date
- `404`: Agent not found

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)