zevuki mailbox

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.

Request
curl https://mail.zevuki.com/v1/emails/em_5Gk2… \
  -H "Authorization: Bearer $ZEVUKI_API_KEY"
200 OK
{
  "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

ValueMeaning
scheduledWaiting to be sent at its scheduled_at time.
canceledA scheduled email that was canceled.
queuedAccepted by Zevuki, not yet handed to the receiving server.
sentHanded to Amazon SES for delivery.
deliveredThe receiving server accepted it. Where it lands (inbox, spam) is up to the receiver.
delayedThe receiving server asked to try again later. Zevuki keeps retrying.
soft_bouncedA temporary failure, like a full mailbox.
bouncedPermanent failure, like an address that doesn't exist. The address is added to your blocked list.
complainedThe recipient marked it as spam. The address is added to your blocked list.
rejectedNot sent, for example because the content was flagged.
failedA 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.

200 OK
{
  "object": "list",
  "data": [
    { "object": "domain", "id": "12", "name": "acme.dev", "status": "verified", "receiving": true, "region": "ap-southeast-2", "created_at": "..." }
  ]
}