Outreach Metrics

Get historical stage distribution for outreach contacts

GET
/api/outreach-metrics/history

Returns counts of pipeline-stage transitions for outreach contacts grouped by period (day/week/month), stage, and lead source. Backed by ContactPipelineTransition records and scoped to the org's outreach configs.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

from*string

Inclusive lower bound on transition createdAt.

Formatdate-time
to*string

Inclusive upper bound on transition createdAt.

Formatdate-time
groupBy?string
Default"day"

Value in

  • "day"
  • "week"
  • "month"
source?string

Optional source name filter (case-insensitive exact match).

filterUserId?string

Admin-only. Target a specific user, or 'all' for the whole organization.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/outreach-metrics/history?from=2019-08-24T14%3A15%3A22Z&to=2019-08-24T14%3A15%3A22Z"
{  "success": true,  "data": [    {      "period": "2026-05-17",      "stage": "Contacted",      "source": "Facebook Lead Ad",      "count": 12    },    {      "period": "2026-05-17",      "stage": "Closed Won",      "source": "Facebook Lead Ad",      "count": 3    }  ]}