Email Sends

List sent emails

Changed on

Lists the recent 14-day delivery history with dashboard-equivalent subject, recipient, status, type, bounce, source, pagination, and sorting filters. Pending, successful, and failed test sends are listed with isTestEmail set to true. Copied-recipient bookkeeping rows remain hidden except bounced or complained copied recipients.

get/email-sends

Request

  • Base URL
    https://api.sequenzy.com/api/v1
  • URL
    https://api.sequenzy.com/api/v1/email-sends
  • Auth
    HTTP bearer

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' | 'Soft' | 'Blocked'

Transient is every temporary bounce. Blocked is the part the receiving server refused over content, policy or reputation, and Soft is the rest.

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.

mailboxProviderstring

Recipient mailbox provider, with the same values and domain classification as the analytics mailboxProvider filter (e.g. gmail, microsoft, yahoo, icloud, orange). other matches every recipient domain outside the named providers. Case-insensitive; an unknown value returns 400.

listIdstring

Only sends to active subscribers currently on this list, the same audience the analytics list filter uses. A list ID from another company matches no rows.

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

  • 038394898ddfRevision changes
    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

  • 252c4dc556c7Revision changes
    • info

      added the new enum value Blocked to the query request parameter bounceType

    • info

      added the new enum value Soft to the query request parameter bounceType