Skip to content
Docs

Get Sequence Variant Stats

Compare the A/B variants of a sequence step.

GET/api/v1/campaigns/{campaign_id}/sequences/{sequence_id}/variant-stats

Requires an API key with the read scope.

Counts the emails sent for this step by each variant, how many were opened, how many got a reply and how many bounced. Rates are percentages of sent. A step with no variants returns an empty array.

Path Parameters#

campaign_idstringpathrequired
The campaign.
sequence_idstringpathrequired
The sequence step.

Response#

dataarray
Show Variant stats
variantIdstring
The variant.
labelstring
Its label.
sentinteger
Emails sent.
openedinteger
Emails opened.
repliedinteger
Replies received.
bouncedinteger
Emails that bounced.
openRatenumber
opened / sent in percent, one decimal.
replyRatenumber
replied / sent in percent, one decimal.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: read
404Campaign or sequence step not found in this workspace

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