Mailbox details

GET 
/mail/mailboxes/:mailbox_id

Returns the mailbox, storage usage, access state, paid term, auto-renewal setting, sending limits and usage. All dates are UTC. A null paid_until means the paid period is not yet confirmed.

Sending limits are independent of storage: 1000 recipients in the last 24 hours, or 5000 with outbound_high_limit=true; 30 messages in the last 60 seconds; 50 recipients per message across To/Cc/Bcc. SMTP and API share the counters. Usage counts accepted sending attempts, not confirmed delivery. remaining=max(0, limit-used). If usage cannot be read, the request returns 503 rather than zero usage.

Request

Responses

200

Successful response

401

Missing or invalid key, mismatched ID, or inactive integration

403

Access denied.

404

Resource not found in this integration.

409

Resource state, payment, price or idempotency conflict. See the mail guide for error codes.

422

Invalid request fields or unsupported parameters

500

Unexpected server error

503

Mail service or usage data temporarily unavailable.