sendsend.email
Sign inStart building

List emails

GET/v1/emails

Newest first, with cursor pagination. Pass the next_cursor from one page as cursor for the next.

Required scope: emails:read

Parameters

NameInDescription
limitoptionalqueryPage size, 1 to 100. Default 20.
cursoroptionalqueryCursor from a previous page.
statusoptionalqueryOnly messages with this status.
tooptionalqueryOnly messages sent to this address.

Example

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

Response 200

{
  "data": [
    {
      "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"
    }
  ],
  "next_cursor": null
}

Errors

StatusCodeWhen
400validation_errorThe request body or parameters are invalid. The message says which field.
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.