Delivery status
Every email has a status and a timeline of delivery events, one per recipient. Find them on the Emails page in the dashboard, or with the API.
Get an email
GET https://mail.zevuki.com/v1/emails/{id} needs a key with full access.
curl https://mail.zevuki.com/v1/emails/em_5Gk2… \ -H "Authorization: Bearer $ZEVUKI_API_KEY"
{
"email": {
"id": "em_5Gk2…",
"from": "Acme <hello@acme.dev>",
"to": ["maya@example.com"],
"subject": "Welcome to Acme",
"status": "delivered",
"message_id": "…",
"created_at": "2026-11-14T10:02:11Z"
},
"events": [
{ "type": "sent", "recipient": "maya@example.com", "detail": "", "at": "2026-11-14T10:02:12Z" },
{ "type": "delivered", "recipient": "maya@example.com", "detail": "250 2.0.0 OK", "at": "2026-11-14T10:02:14Z" }
]
}Statuses and events
| Value | Meaning |
|---|---|
scheduled | Waiting to be sent at its scheduled_at time. |
canceled | A scheduled email that was canceled. |
queued | Accepted by Zevuki, not yet handed to the receiving server. |
sent | Handed to Amazon SES for delivery. |
delivered | The receiving server accepted it. Where it lands (inbox, spam) is up to the receiver. |
delayed | The receiving server asked to try again later. Zevuki keeps retrying. |
soft_bounced | A temporary failure, like a full mailbox. |
bounced | Permanent failure, like an address that doesn't exist. The address is added to your blocked list. |
complained | The recipient marked it as spam. The address is added to your blocked list. |
rejected | Not sent, for example because the content was flagged. |
failed | A scheduled email that couldn't be sent when due. The event's detail says why. |
Get these as they happen with webhooks instead of polling. An email's status is the most important event among its recipients. Events usually arrive within a minute of sending; the detail field carries the receiving server's own words when there are any.
List your domains
GET https://mail.zevuki.com/v1/domains (full access) returns your domains and whether each is verified. See Managing domains with the API for the rest.
{
"object": "list",
"data": [
{ "object": "domain", "id": "12", "name": "acme.dev", "status": "verified", "receiving": true, "region": "ap-southeast-2", "created_at": "..." }
]
}