List Emails
List transactional API emails, newest first.
MethodGET
/api/v2/emailsLists transactional emails created through the API, newest first. Campaign sends and test emails are excluded (campaignId null, isTest false). Permission: emails.
List rows are metadata plus last_event. They do not include html, text, or tags. Fetch the body with Get Email.
Query Parameters
| Name | Type | Description |
|---|---|---|
limit | integer | Page size. Default 20. Min 1, max 100. |
after | string | Return emails older than this id (next page, walking backward in time). |
before | string | Return emails newer than this id. |
Pass after or before, not both. The cursor must be an email id that exists in this organization.
Response Fields
| Field | Type | Description |
|---|---|---|
object | "list" | Discriminator. Always list. |
has_more | boolean | true when another page exists in the same direction. |
data | array | Email objects, newest first. Same fields as Get Email except object, html, text, and tags. |
last_event uses the same mapping as Get Email.
Errors
| Status | name | When |
|---|---|---|
| 401 | missing_api_key | Missing or invalid bearer token |
| 403 | validation_error | Token lacks the emails permission |
| 422 | validation_error | Both after and before, or cursor id not found |