List Inboxes

Inboxes are returned newest first. Results are paginated with cursors. See Pagination for how after and before work.

<>

  {isRequired ? 

• limit (number) — Number of inboxes to retrieve.

  • Default value: 20

  • Maximum value: 100

  • Minimum value: 1

: <>

Note that the limit parameter is optional. If you do not provide a limit, all inboxes will be returned in a single response.

• limit (number) — Number of inboxes to retrieve.

  • Maximum value: 100

  • Minimum value: 1

    </>}

    • after (string) — The ID after which we'll retrieve more inboxes (for pagination). This ID will not be included in the returned list. Cannot be used with the before parameter.

    • before (string) — The ID before which we'll retrieve more inboxes (for pagination). This ID will not be included in the returned list. Cannot be used with the after parameter.

    </>

• object (string) — Always list.

• has_more (boolean) — Whether more inboxes exist beyond this page.

• data (array) — The inboxes on this page.

  properties

  • id (string) — The ID of the inbox.
  • name (string | null) — Internal name for the inbox. Recipients do not see it.
  • email_address (string) — The address of the inbox.
  • friendly_name (string | null) — The name recipients see when mail is sent from this inbox. A plain name, not a Name <email> address.
  • unread (number) — The number of unread threads in the inbox.
  • last_received (string | null) — ISO 8601 timestamp when a thread in this inbox was last active.

import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.inboxes.list();

curl -X GET 'https://api.resend.com/inboxes' \
     -H 'Authorization: Bearer re_xxxxxxxxx'

resend inboxes list

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
      "name": "Customer Support",
      "email_address": "support@example.com",
      "friendly_name": "Ada from Support",
      "unread": 3,
      "last_received": "2026-08-05T14:03:11.229Z"
    },
    {
      "id": "1c5e0f3a-6b21-4d9a-8e77-5c0a9d8b4e12",
      "name": "billing@example.com",
      "email_address": "billing@example.com",
      "friendly_name": null,
      "unread": 0,
      "last_received": null
    }
  ]
}