PricingDocsCompareGuidesBlog
API referenceEmails

List emails

GET/emails

Sent and scheduled emails, newest first, cursor-paginated.

Authorization

apiKey
AuthorizationBearer <token>

A project API key: Authorization: Bearer s0_…

In: header

Query Parameters

limit?integer
Range1 <= value <= 100
after?string
Length1 <= length <= 64
before?string
Length1 <= length <= 64
status?string

Value in

  • "scheduled"
  • "queued"
  • "sent"
  • "delivered"
  • "delivery_delayed"
  • "opened"
  • "clicked"
  • "bounced"
  • "complained"
  • "rejected"
  • "failed"
  • "suppressed"
  • "canceled"
query?string
Length1 <= length <= 200

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/emails"
{  "object": "list",  "has_more": true,  "data": [    {      "object": "email",      "id": "string",      "from": "string",      "to": [        "string"      ],      "cc": [        "string"      ],      "bcc": [        "string"      ],      "reply_to": [        "string"      ],      "subject": "string",      "created_at": "2019-08-24T14:15:22Z",      "scheduled_at": "2019-08-24T14:15:22Z",      "last_event": "scheduled",      "tags": [        {          "name": "string",          "value": "string"        }      ]    }  ]}

API overview

Base URL, authentication, API key types, errors, pagination, rate limits and idempotency of the Resend-compatible Stamp0 REST API.

Send an email POST

Queues one email for sending through SES in your AWS account. Accepts `scheduled_at` (ISO 8601 or natural language, up to 30 days ahead) and an `Idempotency-Key` header. The `from` domain must be a verified domain of the project with sending enabled. With `template: { id, variables }` (a published template by id or alias) the body comes from the template; `html` and `text` may then not be set, and `from`, `subject` and `reply_to` override the template defaults.