List Inboxes
GET
/
inboxes
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
}
]
}Inboxes are returned newest first. Results are paginated with cursors. See Pagination for how after and before work.
Response Fields
Section titled “Response Fields”string
Always list.
boolean
Whether more inboxes exist beyond this page.
array
The inboxes on this page.
Hide properties
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 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.
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
}
]
}Was this page helpful?
⌘I