apicheats.dev resend/llms.txt Raw .md
GET

/emails/receiving

Resend API

Retrieve a list of received emails

Base URL
https://api.resend.com
Auth
Authorization: Bearer <RESEND_API_KEY>
Last verified
2026-09-03 · upstream hash matched
Actions
Agents: curl -H "Accept: text/markdown" this URL
→ 218 tokens · Vary: Accept

Critical gotchas

All requests must include a User-Agent header (e.g. User-Agent: my-app/1.0) or the API returns HTTP 403.

The to field is an array of strings, even when sending to a single recipient.

cURL

curl -X GET 'https://api.resend.com/emails/receiving?limit=10&after=example-after&before=example-before' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0'
Get a free Resend API key → sponsored

Parameters

Name In Type Required Description
limit query integer No Maximum number of received emails to return.
after query string No Pagination cursor to fetch results after this email ID. Cannot be used with 'before'.
before query string No Pagination cursor to fetch results before this email ID. Cannot be used with 'after'.

Response 200 OK

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "to": [
        "delivered@resend.dev"
      ],
      "from": "sender@example.com",
      "subject": "Hello World",
      "message_id": "<message-id@email.example.com>",
      "bcc": [
        "string"
      ],
      "cc": [
        "string"
      ],
      "reply_to": [
        "string"
      ],
      "created_at": "2023-10-06T23:47:56.678Z",
      "attachments": [
        {
          "id": "00000000-0000-4000-8000-000000000000",
          "filename": "string",
          "content_type": "string",
          "content_id": "string",
          "content_disposition": "inline",
          "size": 0
        }
      ]
    }
  ]
}