List Labels
Retrieve the labels on an inbox.
Returns every label on the inbox, oldest first.
Path Parameters
Section titled “Path Parameters”The Inbox ID.
Response Fields
Section titled “Response Fields”-
object(string) — Alwayslist. -
data(array) — The labels on the inbox, oldest first.properties
id(string) — The ID of the label.name(string) — The name of the label.color(string) — The color of the label:cyan,teal,grass,lime,yellow,orange,iris,plum,crimson,bronze, ormauve.created_at(string) — ISO 8601 timestamp when the label was created.
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.inboxes.labels.list({
inboxId: 'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
});curl -X GET 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1/labels' \
-H 'Authorization: Bearer re_xxxxxxxxx'resend inboxes labels list --inbox_id b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1{
"object": "list",
"data": [
{
"id": "2a8b4c6d-1e3f-4a5b-9c7d-8e0f1a2b3c4d",
"name": "Billing",
"color": "cyan",
"created_at": "2026-08-01T09:12:03.004Z"
},
{
"id": "7f9c1d2e-4a6b-4c3d-8e15-9b0a7c6d5e34",
"name": "Urgent",
"color": "crimson",
"created_at": "2026-08-05T14:07:42.881Z"
}
]
}