---
title: "Per-flow execution metrics (starts, completions, drop-off)"
method: GET
path: "/{teamPid}/analytics/flows"
tags: ["Analytics"]
---

# Per-flow execution metrics (starts, completions, drop-off)

`GET /{teamPid}/analytics/flows`

## Request

- Base URL: `https://api.rightmessage.com/v1`
- URL: `https://api.rightmessage.com/v1/{teamPid}/analytics/flows`
- Auth: HTTP bearer

With `flow_ids`, `data.flows` maps each flow ID to the same object a single `flow_id` returns.

Requires an API token with the `read` or `write` ability. Tokens created without abilities have `*`, which grants every ability.

## Path parameters

- `teamPid` string, required

## Query parameters

- `start` string, date-time, required
- `end` string, date-time, required
- `timezone` string
- `flow_id` string
- `flow_ids[]` string[]

## Response `200`

- object
  - `data` union, required
    - object
      - `flowMetrics` object, required
        - `totalExecutions` integer, required
        - `completedRuns` integer, required
        - `unfinishedRuns` integer, required
        - `uniqueVisitors` integer, required
        - `identifiedVisitors` integer, required
        - `avgDurationMs` number, required
        - `completionBreakdown` object, required
        - `byFlow` object[], required
          - `flowId` string, required
          - `executions` integer, required
          - `uniqueVisitors` integer, required
          - `completionRate` number, required
        - `funnel` object, nullable, required
          - `views` integer, required
          - `starts` integer, required
          - `submissions` integer, required
          - `completionRate` number, nullable, required
          - `avgTimeToCompleteMs` integer, nullable, required
        - `insights` object, nullable, required
          - `topDropOffs` object[], required
            - `nodeId` string, required
            - `nodeType` string, required
            - `droppedCount` integer, required
          - `highestDropOffQuestion` object, nullable, required
            - `nodeId` string, required
            - `droppedCount` integer, required
            - `visitorCount` integer, required
            - `dropOffRate` number, required
          - `highestAbandonmentOffer` object, nullable, required
            - `nodeId` string, required
            - `conversions` integer, required
            - `visitorCount` integer, required
            - `abandonmentRate` number, required
          - `slowestQuestion` object, nullable, required
            - `nodeId` string, required
            - `avgDurationMs` integer, required
      - `nodeMetrics` object, required
      - `exposurePages` object[], required
        - `url` string, required
        - `pathname` string, required
        - `hostname` string, required
        - `uniqueVisitors` integer, required
        - `executions` integer, required
    - object
      - `flows` object, required

## Other responses

- `401`: Missing, invalid or revoked API token.
- `404`: Not found
- `422`: Validation error
- `429`: Rate limit exceeded: 120 requests per minute for project endpoints, 60 per minute for token and connection endpoints. Retry after the `Retry-After` seconds.
- `503`

---

[API](https://skmtc.dev/rightmessage/apis/rightmessage-api.md) - [All operations](https://skmtc.dev/rightmessage/apis/rightmessage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rightmessage/apis/rightmessage-api/revisions/adec35e9720c?raw)