/v1/workspaces/{workspace_id}/emails/{id}AuthRetrieve 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 · uuidId of the workspace.
id*string · uuidId of the email.
Response · 200
id*string · uuidThe email id.
from*string · emailThe From address (bare address).
to*arrayThe `To` recipients.
cc*arrayCc recipients.
bcc*arrayBcc recipients.
reply_to*arrayReply-To addresses.
subject*stringSubject line; null when the email has none.
template_name*stringThe template it was rendered from; null for html/text sends.
tags*arrayTags attached to the email.
last_event*objectThe 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*numberRecipients, one message each.
created_at*string · date-timeWhen the email was accepted.
headers*objectThe custom headers as sent. Values of headers whose names suggest a credential (auth, token, secret, key, signature, cookie, session) read `[redacted]`.
messages*arrayOne message per recipient, in send order.
Example
Request
GET https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/emails/{id}
Authorization: Bearer YOUR_TOKENResponse
{
"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": {}
}
]
}