Outreach Metrics
Get historical stage distribution for outreach contacts
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.
Format
date-timeto*string
Inclusive upper bound on transition createdAt.
Format
date-timegroupBy?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 } ]}