List emails | Resend API (unofficial showcase)

3 parameters

limitintegeroptional

Maximum number of emails to return. Must be between 1 and 100 when supplied.

afterstringoptional

Return emails after this pagination cursor.

beforestringoptional

Return emails before this pagination cursor.

1 status code

200Returns an object containing an array of email records and a `has_more` flag indicating whether more results are available.

objectstringoptional

Type of the response object.

has_morebooleanoptional

Indicates if there are more results available.

dataarray<object>optional

Array containing email information.

Error handling

limit must be between 1 and 100 when supplied. Use after or before to specify a cursor for the results.

import { Client } from "@octridev/resend";

const client = new Client({
  baseUrl: "https://api.resend.com",
  auth: { bearer: process.env.API_TOKEN },
});

const result = await client.emails.list({
  limit: 20,
  after: "example",
  before: "example",
});

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "email",
      "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
      "message_id": "<202301010000.4ef9a417@email.example.com>",
      "to": [
        "delivered@resend.dev"
      ],
      "from": "Acme <onboarding@resend.dev>",
      "created_at": "2023-04-03 22:13:42.674981+00",
      "subject": "Hello World",
      "html": "Congrats on sending your <strong>first email</strong>!",
      "text": "example_value",
      "bcc": [
        "example_value"
      ],
      "cc": [
        "example_value"
      ],
      "reply_to": [
        "example_value"
      ],
      "last_event": "delivered"
    }
  ]
}

Request

Response

Errors