Skip to main content
GET
/
api
/
outreach-metrics
/
history
Get historical stage distribution for outreach contacts
curl --request GET \
  --url https://your-instance.example.com/api/outreach-metrics/history \
  --header 'Authorization: Bearer <token>'
{
  "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
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
from
string<date-time>
required

Inclusive lower bound on transition createdAt.

​
to
string<date-time>
required

Inclusive upper bound on transition createdAt.

​
groupBy
enum<string>
default:day
Available options:
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

History returned

​
success
boolean
required
​
data
object[]
required