Skip to main content
Resend Docs
current

Search documentation

Type to search this documentation.

On this pageOverview

Retrieve Inbox

Retrieve a single inbox by its ID.

The Inbox ID.

  • object (string) — Always inbox.

  • 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.

  • forwarding_address (string | null) — The address to forward mail to when forwarding is enabled. null otherwise.

  • 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.

  • drafts (number) — The number of unsent drafts.

  • last_received (string | null) — ISO 8601 timestamp when a thread in this inbox was last active.

Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.inboxes.get(
  'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
);
cURL
curl -X GET 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1' \
     -H 'Authorization: Bearer re_xxxxxxxxx'
CLI
resend inboxes get b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1
Response
{
  "object": "inbox",
  "id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
  "name": "Customer Support",
  "email_address": "support@example.com",
  "forwarding_address": null,
  "friendly_name": "Ada from Support",
  "unread": 3,
  "drafts": 2,
  "last_received": "2026-08-05T14:03:11.229Z"
}
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu