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 stored for a limited window depending on your plan. Records older than the retention period are automatically removed.
| 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) |