Get a mailbox
GET
/v1/email/mailboxes/{mailbox_id}
const mailbox = await bird.email.mailboxes.get("mbx_01abc");
console.log(mailbox.state); // "active"mailbox = client.email.mailboxes.get("mbx_01krdgeqcxet5s7t44vh8rt9mg")
print(mailbox.address)mailbox, err := client.Email.Mailboxes.Get(context.Background(), "mbx_123")
if err != nil {
log.Fatal(err)
}
fmt.Println(*mailbox.Address)$mailbox = $bird->email->mailboxes->get('mbx_01krdgeqcxet5s7t44vh8rt9mg');
echo $mailbox->getAddress(), ' ', $mailbox->getState();bird email mailboxes get <mailbox-id>curl -X GET "https://us1.platform.bird.com/v1/email/mailboxes/{mailbox_id}" \
-H "Authorization: Bearer $TOKEN"响应200
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "concierge@inbox.ai",
"display_name": "Acme Concierge",
"receive_policy": "open",
"state": "active",
"channel": "email",
"owner": {
"type": "workspace",
"id": "ws_01krdgeqcxet5s7t44vh8rt9mg"
},
"inbound_address_id": "ina_01krdgeqcxet5s7t44vh8rt9mg",
"retention_tier": "30d"
}
Returns a single mailbox by ID. A mailbox deleted within its 30-day restore window is still returned, with deleted_at set. Once the window closes it is permanently removed and returns 404.
参数
mailbox_id
string
Mailbox identifier. Starts with mbx_.
响应载荷
id
string
必填
Mailbox ID.
address
string
必填
The mailbox's email address. Immutable once created.
display_name
nullable string
必填
Display name used as the sender name on mail from this mailbox. null when unset.
default_reply_to
nullable string
必填
Default Reply-To address stamped on mail sent from this mailbox. null when unset.
receive_policy
string
必填
Which inbound mail the mailbox accepts:
- open: Accepts everything not blocked by a rule.
- replies_only: Accepts only replies to messages this mailbox has sent. A reply must match a message the mailbox sent. Landing in an existing thread by itself does not count.
- allowlist: Accepts only senders matching an allow rule. Replies to prior outbound mail are always admitted unless blocked.
- drop: Stores nothing.
Possible values: open, replies_only, allowlist, drop
state
string
必填
Lifecycle state. active means the mailbox can send, receive, and expose conversations. suspended pauses sending, conversation reads, and events; inbound mail is retained with the blocked label until you resume it.
Possible values: active, suspended
channel
string
必填
The channel this mailbox receives on. Always email.
Possible values: email
owner
object
必填
The principal that owns the mailbox. Always the workspace.
显示子属性
owner.type
string
必填
Owner principal type.
Possible values: workspace
owner.id
string
必填
Owner principal ID.
inbound_address_id
string
必填
The underlying inbound address that receives this mailbox's mail.
retention_tier
string
必填
How long message metadata, extracted text, and attachments are kept. Original bodies and inbound raw MIME are limited to 30 days on every tier.
Possible values: 30d, 90d, 1y
message_count
integer
必填
Number of retained messages across all threads.
thread_count
integer
必填
Number of retained threads.
size_bytes
integer
必填
Stored bytes across the mailbox's retained messages: subject, preview, extracted text, and attachment bytes. Message bodies and raw MIME expire after 30 days and do not count. Maintained with each message written or deleted, so the value is current; messages stored before the counter existed are not counted.
unread_thread_count
nullable integer
Number of threads with unread messages in this mailbox, excluding trash. null on create/update responses.
metadata
object
必填
Your own key/value data attached to the mailbox. Up to 2 KB. Keys starting with __bird are reserved.
local_part_generated
boolean
必填
Whether we generated the local part of the address. false means a custom handle was chosen at creation. On the shared inbox.ai domain a custom handle counts against your plan's custom-handle allowance.
created_at
string
必填
When the mailbox was created.
updated_at
string
必填
When the mailbox was last updated.
deleted_at
nullable string
When the mailbox was deleted, or null if active. Deletion stops receiving; restore is available for 30 days unless permanent erasure has started.