Get Inbox

GetInbox returns unified inbox with emails from all identities GET /api/v1/inbox

Authentication & compatibility

Use a scoped bearer API key with email:read. The key is bound to its user and organization.

Legacy mailbox operation requiring configured Stalwart/JMAP accounts. This is not the SES received-mail API; use /inbox/received and /inbox/changes for SES automation.

Contract 2026-10-04. Your running instance's /api/v1/openapi.json is authoritative for its deployed release.

Request

Set MAILAT_BASE_URL to your instance origin (without /api/v1) and MAILAT_TOKEN to an appropriate credential. Replace path placeholders and example data before running. These examples do not execute in this page.

curl --request GET "$MAILAT_BASE_URL/api/v1/inbox" \
  --header "Authorization: Bearer $MAILAT_TOKEN"

Responses

HTTP statuses and body shapes below come from the pinned contract. Not every shared error applies to every request. Retain the original idempotency key when retrying a send.