Sign in
Email Sends

List sent emails

Lists the recent 14-day delivery history with dashboard-equivalent subject, recipient, status, type, bounce, source, pagination, and sorting filters. Successful test sends and copied-recipient bookkeeping rows are hidden; a test send that failed, bounced, or was suppressed IS listed, flagged with an isTestEmail value of true, because it is the only record of a test that never arrived.

get/email-sends

Query parameters

searchstring

Case-insensitive subject/title or recipient search. q is accepted as an alias.

qstring

Compatibility alias for search.

subjectstring

Case-insensitive subject/title filter. title is accepted as an alias.

titlestring

Compatibility alias for subject.

recipientstring

Case-insensitive recipient email filter.

status'pending' | 'sent' | 'delivered' | 'opened' | 'clicked' | 'bounced' | 'complained' | 'failed' | 'suppressed'

Delivery status. Opened includes clicked deliveries.

emailType'campaign' | 'transactional' | 'sequence'
bounceType'Permanent' | 'Transient'
campaignIdstring
transactionalEmailIdstring
automationIdstring
automationNodeIdstring

Filter to one email step of a sequence. Take the node ID from the steps array of the sequence metrics endpoint. Combined with automationId the two intersect.

daysinteger
pageinteger
limitinteger
sortField'recipientEmail' | 'subject' | 'status' | 'eventAt' | 'sentAt' | 'createdAt'
sortOrder'asc' | 'desc'

Response

Paginated sent-email history

successboolean
retentionDaysinteger

Example response

{
  "retentionDays": 14,
  "emailSends": [
    {
      "id": "send_123",
      "companyId": "company_123",
      "subject": "Welcome"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "totalPages": 5
  }
}

Changes