Retrieve a received email
GET/api/v1/email/received/{id}
GET /email/received/{id}
curl -X GET 'https://www.unitpost.com/api/v1/email/received/email_123' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'User-Agent: my-app/1.0'Response · 200
{
"object": "received_email",
"id": "id_123",
"from": "you@yourdomain.com",
"from_name": "string",
"to": [
"customer@example.com"
],
"cc": [
"string"
],
"bcc": [
"string"
],
"message_id": "message_123",
"subject": "Welcome to Acme",
"text": "string",
"html": "string",
"spam_verdict": "string",
"virus_verdict": "string",
"spf_verdict": "string",
"dkim_verdict": "string",
"dmarc_verdict": "string",
"size": 1,
"attachments": [
{
"object": "received_attachment",
"id": "id_123",
"filename": "string",
"content_type": "string",
"content_disposition": "string",
"content_id": "content_123",
"size": 1
}
],
"received_at": "2026-01-01T00:00:00.000Z",
"created_at": "2026-01-01T00:00:00.000Z",
"thread_id": "thread_123",
"reply_to": [
"string"
],
"headers": {},
"sent_by_us": false
}Retrieve a full inbound message by id, including its HTML and text bodies plus metadata for every attachment. Attachment bytes aren't inlined — download each one via Get an attachment download URL. Browse your inbound mail with List received emails. Requires the emails:read capability.
Parameters1 field
| Field | Type | Description |
|---|---|---|
idrequired | string · path | — |
Response · 200 fields24 fields
| Field | Type | Description |
|---|---|---|
objectrequired | string | — |
idrequired | string | — |
fromrequired | string | — |
from_namerequired | string | null | — |
torequired | string[] | — |
ccrequired | string[] | — |
bccrequired | string[] | — |
message_idrequired | string | null | — |
subjectrequired | string | null | — |
textrequired | string | null | — |
htmlrequired | string | null | — |
spam_verdictrequired | string | null | — |
virus_verdictrequired | string | null | — |
spf_verdictrequired | string | null | — |
dkim_verdictrequired | string | null | — |
dmarc_verdictrequired | string | null | — |
sizerequired | number | — |
attachmentsrequired | object[] | — |
received_atrequired | string | — |
created_atrequired | string | — |
thread_id | string | null | The conversation (`thr_…`); null until the message is threaded. |
reply_to | string[] | Reply-To addresses: answer these before `from` when present. |
headers | object | The headers we keep, by lower-case name: `date`, `in-reply-to`, `references`, `reply-to`, `return-path`, `list-unsubscribe` (when present). |
sent_by_us | boolean | A copy of one of your own sends that came back to your receiving domain. Its `text` and `html` are null: sent bodies aren't on the API (they can carry a sign-in or reset link). |
200401403404