List received emails
GET/api/v1/email/received
curl -X GET 'https://www.unitpost.com/api/v1/email/received' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'User-Agent: my-app/1.0'{
"object": "list",
"has_more": false,
"data": [
{
"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",
"spam_verdict": "string",
"virus_verdict": "string",
"spf_verdict": "string",
"dkim_verdict": "string",
"dmarc_verdict": "string",
"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"
],
"attachment_count": 1
}
]
}Retrieve a list of inbound emails received on your receiving-enabled domains, newest-first and cursor-paginated. Rows are summaries (sender, subject, timestamps) without bodies — use a message's id with Retrieve a received email to read the full content and attachment metadata. Narrow the list with to (one address in the To or Cc header), thread_id (one conversation) and a created_after / created_before range. Requires the emails:read capability.
Parameters7 fields
| Field | Type | Description |
|---|---|---|
limit | integer · query | Max rows to return (default 20, max 100). |
after | string · query | Return rows after this id (forward paging). |
before | string · query | Return rows before this id (backward paging). |
to | string · query | Only mail with this address in its To or Cc header, in any case. Envelope recipients aren't stored, so a Bcc copy or a forward to one of your addresses is matched by its headers only. |
thread_id | string · query | Only the messages of this conversation (`thr_…`), as `thread_id` on a received email and on the `email.received` webhook. |
created_after | string · query | Only mail whose `created_at` is at/after this ISO 8601 time (with `Z` or an offset). |
created_before | string · query | Only mail whose `created_at` is at/before this ISO 8601 time (with `Z` or an offset). |
Response · 200 fields20 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 | — |
spam_verdictrequired | string | null | — |
virus_verdictrequired | string | null | — |
spf_verdictrequired | string | null | — |
dkim_verdictrequired | string | null | — |
dmarc_verdictrequired | string | null | — |
sizerequired | number | — |
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. |
attachment_countrequired | number | — |