sendsend.email

Retrieve an email

GET/v1/emails/{id}

Returns the message, its overall status and the status of each recipient. Delivery means the recipient’s mail server accepted the message, not that it reached the inbox.

Required scope: emails:read

Parameters

NameInDescription
idrequiredpathThe email id.

Example

curl -X GET 'https://api.sendsend.email/v1/emails/ID' \
  -H "Authorization: Bearer $SENDSEND_API_KEY"

Response 200

{
  "id": "msg_8Xk2pQwLr0aVn3Zt",
  "object": "email",
  "environment": "live",
  "status": "accepted",
  "status_reason": null,
  "simulated": false,
  "from": "Acme <hello@mail.acme.com>",
  "to": [
    "maria@example.com"
  ],
  "cc": [],
  "bcc": [],
  "reply_to": null,
  "subject": "Welcome to Acme",
  "template_id": null,
  "template_version": null,
  "tags": {
    "application_reference": "signup_123"
  },
  "provider_message_id": "0100019…",
  "request_id": "req_Kd83…",
  "attempts": 1,
  "recipients": [
    {
      "address": "maria@example.com",
      "kind": "to",
      "status": "delivered"
    }
  ],
  "created_at": "2026-10-06T15:04:05.000Z",
  "updated_at": "2026-10-06T15:04:07.000Z"
}

Errors

StatusCodeWhen
404not_foundNo such resource in this project.
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.
429rate_limitedToo many requests. Wait for the number of seconds in the Retry-After header.

Every error has the same shape. See Errors.