Mail API reference

Mail API · Emails

get/v1/workspaces/{workspace_id}/emails/{id}Auth

Retrieve an email

The email as sent (from, to, cc, bcc, reply_to, subject, tags, custom headers) with one entry per recipient message and `last_event`, the worst status across them. Bodies are on `GET /messages/{id}/body`.

Path parameters

workspace_id*string · uuid

Id of the workspace.

id*string · uuid

Id of the email.

Response · 200

id*string · uuid

The email id.

from*string · email

The From address (bare address).

to*array

The `To` recipients.

cc*array

Cc recipients.

bcc*array

Bcc recipients.

reply_to*array

Reply-To addresses.

subject*string

Subject line; null when the email has none.

template_name*string

The template it was rendered from; null for html/text sends.

tags*array

Tags attached to the email.

last_event*object

The worst status across the email's messages, worst first: complained, bounced, failed, suppressed, deferred, queued, sent, delivered. One message still queued keeps an otherwise delivered email `queued`.

recipient_count*number

Recipients, one message each.

created_at*string · date-time

When the email was accepted.

headers*object

The custom headers as sent. Values of headers whose names suggest a credential (auth, token, secret, key, signature, cookie, session) read `[redacted]`.

messages*array

One message per recipient, in send order.

Example

Request

GET https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/emails/{id}
Authorization: Bearer YOUR_TOKEN

Response

{
  "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",
  "headers": {},
  "messages": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "to": "user@example.com",
      "status": {}
    }
  ]
}