List Received Emails
Retrieve a list of received emails for the authenticated user.
GET
You can list all emails received by your team. The list returns references to individual emails. If needed, you can use the
id of an email to retrieve the email HTML to plain text using the Retrieve Received Email endpoint or the Retrieve Received Attachment endpoint to get an email’s attachments.
This endpoint only returns emails received by your team. If you need to list
emails sent by your team, use the List Sent
Emails endpoint.
Comma-separated recipient addresses. Returns emails received by any of these
addresses. Up to
20 values. Matches are exact and case-sensitive, so
support@example.com doesn’t match Support@example.com.Matches emails received on or after this date. Accepts a date like
2026-09-01 or an ISO 8601 timestamp, in UTC unless the timestamp has an
offset.Matches emails received on or before this date. Same formats as
start_date.
A date covers that whole day, so start_date=2026-09-01&end_date=2026-09-30
covers all of September.If your range starts before your plan’s data retention window, results start
at the beginning of the window.
Errors
Validation errors return422 with the name validation_error.