---
title: "Connection requests and follow-ups sent, by step"
method: GET
path: "/api/v1/analytics/outreach-volume"
tags: ["Analytics"]
---

# Connection requests and follow-ups sent, by step

`GET /api/v1/analytics/outreach-volume`

## Request

- Base URL: `https://www.zen-mode.io`
- URL: `https://www.zen-mode.io/api/v1/analytics/outreach-volume`
- Auth: HTTP bearer

How many connection requests and 1st, 2nd and 3rd follow-ups were SENT in a date range, per campaign and in total. Days are UTC. Follow-ups sent before `recorded_from` are reconstructed from message history and counted in `reconstructed`.

## Query parameters

- `from` string, date
- `to` string, date
- `campaign_id` integer

## Response `200`

Counts per campaign and in total.

- object
  - `from` string
  - `to` string
  - `time_zone` 'UTC'
  - `campaign_id` integer, nullable
  - `totals` object
    - `connection_requests` integer
    - `follow_up_1` integer
    - `follow_up_2` integer
    - `follow_up_3` integer
    - `follow_ups_total` integer
    - `reconstructed` integer
  - `campaigns` object[]
    - `campaign_id` integer
    - `campaign_name` string
    - `campaign_type` string, nullable
    - `connection_requests` integer
    - `follow_up_1` integer
    - `follow_up_2` integer
    - `follow_up_3` integer
    - `follow_ups_total` integer
    - `reconstructed` integer
  - `recorded_from` string, date, nullable: First UTC day on which every follow-up count is recorded at send time rather than reconstructed.

## Other responses

- `400`: Invalid `from`/`to` or `campaign_id`.
- `401`: Missing, malformed or invalid Authorization header, or an unknown API key.
- `403`: The key is valid but the account's plan does not include API access.
- `404`: campaign_id not found for this account.
- `429`: Rate limit exceeded (100 requests/minute). Carries `Retry-After`.
- `500`: Unhandled server error.

---

[API](https://skmtc.dev/zen-mode/apis/zenmode-api.md) · [All operations](https://skmtc.dev/zen-mode/apis/zenmode-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zen-mode/apis/zenmode-api/revisions/2769372f1e3f?raw)