Skip to main content
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.
string
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.
string
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.
string
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 return 422 with the name validation_error.