Mail API reference

Mail API · Emails

get/v1/workspaces/{workspace_id}/emailsAuth

List 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 · uuid

Id of the workspace.

Query parameters

limitinteger

Page size. Defaults to 20; values above 100 are clamped to 100.

cursorstring

Opaque cursor from the previous page's `pagination.next_cursor`. Omit for the first page.

tagobject

Tag filter: `tag[category]=confirm_email`. Up to 10 pairs; an email matches when it carries every one.

Response · 200

data*array

The emails on this page, newest first.

pagination*object
has_more*boolean

Whether more emails follow this page.

next_cursor*string

Cursor 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_TOKEN

Response

{
  "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"
  }
}