List inboxes | Resend API (unofficial showcase)

3 parameters

limitintegeroptional

Maximum number of inboxes to return. Must be between 1 and 100.

afterstringoptional

Return inboxes after this cursor, specified as an inbox ID.

beforestringoptional

Return inboxes before this cursor, specified as an inbox ID.

1 status code

200Returns an object containing a `data` array of inbox summaries and a `has_more` value indicating whether more results are available.

objectstringrequired

Type of the response object.

has_morebooleanrequired

Indicates if there are more results available.

dataarray<object>required

Array containing inbox information.

Error handling

When supplied, limit must be between 1 and 100. Use an inbox ID for after or before, and provide no more than one cursor at a time.

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

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

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

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
      "name": "Customer Support",
      "email_address": "support@acme.com",
      "from_name": "Ada from Support",
      "unread": 3,
      "last_received": "2026-08-05T14:03:11.229Z"
    }
  ]
}

Request

Response

Errors