API reference
Retrieve an email
Look up the latest delivery status using the ID returned when sending.
Request
GET /api/v1/emails/{id}
Use an API key from the project that sent the email. An unknown ID or an ID from another project returns 404.
Shell
curl https://sendery.co/api/v1/emails/35a6b227-1748-412e-8651-430492201670 \
-H "Authorization: Bearer $SENDERY_API_KEY" \
-H 'Accept: application/json'Response
| Field | Description |
|---|---|
id |
Message ID. |
status |
Latest delivery status. |
error_code |
Failure reason, or null. |
created_at |
Acceptance time in UTC. |
submitted_at |
Submission time in UTC, or null before submission. Sandbox results also set this field. |
Recipient details, template variables, and email content are not returned.
200 · application/json
{
"id": "35a6b227-1748-412e-8651-430492201670",
"status": "delivered",
"error_code": null,
"created_at": "2026-09-27T06:00:00.000000Z",
"submitted_at": "2026-09-27T06:00:01.000000Z"
}Check status periodically
Allow a few seconds between checks and set a timeout for polling. Both endpoints share the project’s rate limit. submitted and delayed may change later; a delivery can also be followed by a bounce or complaint.