List emails
Browse delivery logs with cursor pagination and focused filters.
/v1/emails/logsAuthorization
Bearer token
- Authorizationrequiredheader
Send your API key as
Bearer YOUR_API_KEY.
Query parameters
limitoptionalinteger1–100; defaults to 50.
cursoroptionalstringThe previous response's
nextCursor; maximum 1,024 characters.statusoptionalstringOne of
"scheduled""canceled""queued""sending""accepted""delivered""bounced""complained""failed""suppressed"sourceoptionalstringFilter by sending source, such as
apiorsmtp.recipientoptionalstringFilter by recipient.
searchoptionalstringSearch delivery logs.
contactIdoptionalstringFilter by contact.
templateIdoptionalstringFilter by template.
startDateoptionaldate stringStart of the date filter, as an ISO 8601 timestamp.
endDateoptionaldate stringEnd of the date filter, as an ISO 8601 timestamp.
Response
The response contains a collection of delivery summaries.
Each item contains id, created_at, recipient, subject, status, and scheduled_at (the scheduled send time, or null). Use that item's id to retrieve the delivery.
total can be null. Continue with nextCursor while hasMore is true; see Pagination.