/v1/workspaces/{workspace_id}/emailsAuthList emails
One entry per email (send call), newest first, with its recipients and `last_event`, the worst status across its messages. Filter by tags with `tag[name]=value` (repeat for several; all must match). Emails sent before 2026-11-06 appear as one-recipient emails.
Path parameters
workspace_id*string · uuidId of the workspace.
Query parameters
limitintegerPage size. Defaults to 20; values above 100 are clamped to 100.
cursorstringOpaque cursor from the previous page's `pagination.next_cursor`. Omit for the first page.
tagobjectTag filter: `tag[category]=confirm_email`. Up to 10 pairs; an email matches when it carries every one.
Response · 200
data*arrayThe emails on this page, newest first.
pagination*objecthas_more*booleanWhether more emails follow this page.
next_cursor*stringCursor for the next page; null on the last page.
Example
Request
GET https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/emails
Authorization: Bearer YOUR_TOKENResponse
{
"data": [
{
"id": "00000000-0000-0000-0000-000000000000",
"from": "user@example.com",
"to": [
"string"
],
"cc": [
"string"
],
"bcc": [
"string"
],
"reply_to": [
"string"
],
"subject": "string",
"template_name": "string",
"tags": [
{
"name": "category",
"value": "confirm_email"
}
],
"last_event": {},
"recipient_count": 0,
"created_at": "2026-01-01T00:00:00.000Z"
}
],
"pagination": {
"has_more": false,
"next_cursor": "string"
}
}