Retrieve an email
GET/api/v1/email/{id}
GET /email/{id}
curl -X GET 'https://www.unitpost.com/api/v1/email/email_123' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'User-Agent: my-app/1.0'Response · 200
{
"object": "email",
"id": "id_123",
"to": [
"customer@example.com"
],
"from": "you@yourdomain.com",
"subject": "Welcome to Acme",
"template_id": "template_123",
"campaign_id": "campaign_123",
"status": "scheduled",
"last_event": "string",
"scheduled_at": "2026-01-01T00:00:00.000Z",
"sent_at": "2026-01-01T00:00:00.000Z",
"delivered_at": "2026-01-01T00:00:00.000Z",
"opened_at": "2026-01-01T00:00:00.000Z",
"clicked_at": "2026-01-01T00:00:00.000Z",
"canceled_at": "2026-01-01T00:00:00.000Z",
"last_error": "string",
"created_at": "2026-01-01T00:00:00.000Z",
"cc": [
"string"
],
"bcc": [
"string"
],
"reply_to": [
"string"
],
"tags": [
{
"name": "Example",
"value": "string"
}
]
}Retrieve a single email by id, including its current send status and lifecycle timestamps (created, scheduled, sent, delivered, and so on). Find an id by browsing List sent emails. Messages submitted over **SMTP** can also be retrieved by the RFC 5322 Message-ID your mail library stamped on them (URL-encode it, e.g. /email/%3Cabc%40example.com%3E; angle brackets optional) — the id in the SMTP 250 Queued as … reply works too. It also carries the cc, bcc, reply_to and tags the email was sent with (never its body); its delivery events are List an email's events. To change a scheduled or queued email, use Cancel or reschedule an email. Requires the emails:read capability.
Parameters1 field
| Field | Type | Description |
|---|---|---|
idrequired | string · path | — |
Response · 200 fields21 fields
| Field | Type | Description |
|---|---|---|
objectrequired | string | — |
idrequired | string | — |
torequired | string[] | — |
fromrequired | string | — |
subjectrequired | string | — |
template_idrequired | string | null | — |
campaign_idrequired | string | null | — |
statusrequired | enumscheduled | queued | sent | delivered | bounced | complained | canceled | failed | — |
last_eventrequired | string | — |
scheduled_atrequired | string | null | — |
sent_atrequired | string | null | — |
delivered_atrequired | string | null | — |
opened_atrequired | string | null | — |
clicked_atrequired | string | null | — |
canceled_atrequired | string | null | — |
last_errorrequired | string | null | — |
created_atrequired | string | — |
cc | string[] | Cc recipients, as sent. Empty when none. Only on `GET /email/{id}`. |
bcc | string[] | Bcc recipients, as sent. Empty when none. Only on `GET /email/{id}`. |
reply_to | string[] | Reply-To addresses, as sent. Empty when none. Only on `GET /email/{id}`. |
tags | object[] | The send's tags. Empty when none. Only on `GET /email/{id}`. |
200401403404