sendsend.email
Sign inStart building

List received emails

GET/v1/received-emails

Newest first, without bodies. Spam-flagged mail is included with spam: true, and does not trigger an email.received webhook.

Required scope: inbound:manage

Parameters

NameInDescription
limitoptionalqueryPage size, 1 to 100. Default 20.
cursoroptionalqueryThe next_cursor from a previous page.

Example

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

Response 200

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "rcv_Qw3…",
      "object": "received_email",
      "from": "Maria <maria@example.org>",
      "to": [
        "support@k3x9m2qf7a.inbound.sendsend.email"
      ],
      "cc": [],
      "reply_to": null,
      "subject": "Question about my order",
      "message_id": "<abc@example.org>",
      "in_reply_to": null,
      "spam": false,
      "size": 4821,
      "created_at": "2026-10-06T15:04:05.000Z",
      "attachment_count": 1
    }
  ],
  "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.

Every error has the same shape. See Errors.