List Broadcast Sends

GET /v1/broadcasts/{broadcastId}/sends

Retrieve a paginated list of individual email sends for a specific broadcast.

Use Cases:

Monitor delivery status for each recipient
Debug delivery issues for specific recipients
Export send data for reporting
Track engagement at the recipient level

Response Data:
Each send includes:

Delivery status (QUEUED, SENDING, DELIVERED, BOUNCED, COMPLAINED, FAILED)
Timestamps (queuedAt, sentAt, deliveredAt, firstOpenedAt, firstClickedAt, bouncedAt, complainedAt)
Engagement metrics (openCount, clickCount, uniqueLinksClicked)
Bounce details (bounceClassification, lastResponseCode, lastResponseMessage)

Filtering:
Use the status query parameter to filter by delivery status:

QUEUED - Waiting to be sent
SENDING - Currently being sent
DELIVERED - Successfully delivered
BOUNCED - Delivery failed (hard or soft bounce)
COMPLAINED - Recipient marked as spam
FAILED - Permanent delivery failure

Data Retention:
Send details are retained for 60 days after broadcast completion. After this period, individual send records are pruned but aggregate statistics remain available via the /stats endpoint.

Required Scope: read:broadcasts

Path parameters

broadcastIdstringrequired

Unique identifier for the broadcast

Query parameters

statusstring

Filter sends by delivery status

limitinteger

Number of items to return (default: 20, max: 100)

afterstring

Cursor for pagination - ID of the last item from the previous page

beforestring

Cursor for reverse pagination - ID of the first item from the next page

Response

200List of broadcast sends retrieved successfully

objectstringrequired

hasMorebooleanrequired

dataobject[]required

Overview

Contacts

Topics

Segments

Forms

API Keys

Broadcasts

Contact Properties

Transactional Emails

List Broadcast Sends

Path parameters

Query parameters

Response