Sendery
Sendery

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.