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

GET /emails/receiving — Resend API

Resend API

Retrieve a list of received emails

Base URL
https://api.resend.com
Auth
Authorization: Bearer <RESEND_API_KEY>
Last verified
2026-10-20 · upstream hash matched
Actions Try in browser→
Agents: curl -H "Accept: text/markdown" this URL
→ 197 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.

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'

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": [
        "[email protected]"
      ],
      "from": "[email protected]",
      "subject": "Hello World",
      "message_id": "<[email protected]>",
      "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
        }
      ]
    }
  ]
}
Get a free Resend API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.