Delivery Events
Every email sent via the API gets a messageId (UUID) in the 202 response. Use it to track delivery status over time via the events API.
| Status | Meaning |
|---|---|
sent | Our mail server accepted the message and queued it for delivery. |
delivered | The message was successfully handed off to the recipient's mail server. |
bounced | The recipient's mail server rejected the message and returned a bounce notice. |
Log retention
Delivery event records are visible in your dashboard and API for a window that depends on your plan. Once that window passes, a record no longer appears in your delivery events.
Your sending history is retained for a fixed period beyond that window, for delivery records and to detect and prevent fraud, phishing and other abuse. This is the same period described in our Terms, and it does not change with your plan. See account suspension for how that history is used.
| Plan | Retention |
|---|---|
| Free | 1 day |
| Developer | 3 days |
| Growth | 7 days |
| Business | 15 days |
| Enterprise | 30 days |
Timestamps & timezones
All timestamps in event responses (sentAt, deliveredAt, bouncedAt, expiresAt) are returned in UTC. If you are in West Africa Time (WAT = UTC+1), add one hour to convert to local time (e.g. a sentAt of 2026-08-26T23:00:00Z is 2026-08-27 00:00 WAT).Query events
curl "https://api.altermail-console.com.ng/v1/user/email/events?status=delivered&limit=10" \
-H "x-api-token: YOUR_API_TOKEN"Filter by messageId
curl "https://api.altermail-console.com.ng/v1/user/email/events?messageId=YOUR_MESSAGE_ID" \
-H "x-api-token: YOUR_API_TOKEN"Query parameters
| Parameter | Description |
|---|---|
messageId | Filter to a single message |
status | sent | delivered | bounced |
domain | Filter by sender domain |
page | Page number (default 1) |
limit | Results per page (max 100, default 50) |