Skip to main content
Resend Docs

Search documentation

Type to search this documentation.

On this pageOverview

Retrieve Inbox

GET

/

inboxes

/

:inbox_id

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"
}

string

Always inbox.

string

The ID of the inbox.

string | null

Internal name for the inbox. Recipients do not see it.

string

The address of the inbox.

string | null

The address to forward mail to when forwarding is enabled. null otherwise.

string | null

The name recipients see when mail is sent from this inbox. A plain name, not a Name <email> address.

number

The number of unread threads in the inbox.

number

The number of unsent drafts.

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
JSON
{
  "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"
}

Was this page helpful?

⌘I

Suggest an edit

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

Export
Documentation menu