Skip to content
Docs

Get Campaign Cohorts

Sent, opened, replied and bounced per day.

GET/api/v1/campaigns/{campaign_id}/cohorts

Requires an API key with the read scope.

One row per day that had sends or replies in the last days days, newest first. Days are UTC dates, not the campaign's timezone. uniqueLeads counts distinct leads emailed that day. Open Get Campaign Cohort Detail for the emails behind a day.

Path Parameters#

campaign_idstringpathrequired
The campaign.
daysintegerquerydefault 30
How far back, 1 to 90.

Response#

dataobject[]
Show Day
datestring
UTC date, YYYY-MM-DD.
sentinteger
Emails sent.
openedinteger
Emails opened.
repliedinteger
Replies received.
bouncedinteger
Emails that bounced.
uniqueLeadsinteger
Distinct leads emailed.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: read
404Campaign not found in this workspace
422days outside 1 to 90

Rate Limit#

  • 300 requests per minute, shared by every read call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (read).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 4, 2026