Error codes
Every failure answers application/problem+json with a stable
code. Clients translate the code; the API never sends prose meant for end users.
HTTP 400
payment.provider_unavailable |
This payment method isn't available yet. |
HTTP 401
auth.invalid_token |
Your session expired. Please sign in again. |
auth.invalid_credentials |
Wrong e-mail or password. |
auth.totp_required |
Enter the 6-digit code from your authenticator app. |
HTTP 402
points.insufficient |
Not enough points. Top up your wallet. |
payment.failed |
Payment failed or expired. |
HTTP 403
auth.forbidden |
You don't have permission to do that. |
feature.not_entitled |
Upgrade your plan to use this feature. |
domain.suspended |
This domain is suspended because your plan lapsed. Renew within 30 days to keep it. |
HTTP 404
route.not_found |
This endpoint does not exist. |
mailbox.not_found |
This mailbox no longer exists. |
content.not_found |
This page does not exist. |
message.not_found |
This message is gone. |
attachment.not_found |
This attachment is no longer available. Large files are not kept. |
otp.not_found |
No verification code detected yet. |
HTTP 409
mailbox.local_part_taken |
That address is already taken. |
content.key_taken |
Another block already uses that key. |
HTTP 410
mailbox.expired |
This mailbox has expired. |
message.raw_expired |
The original is no longer kept. Downloads are available for 15 minutes, or an hour on a paid plan. |
HTTP 413
payload.too_large |
That attachment is too large. |
HTTP 422
validation.failed |
Some fields are invalid. |
domain.not_available |
This domain isn't available on your plan. |
domain.limit_reached |
No domain slots left. Buy another slot to continue. |
domain.not_verified |
Domain verification is still pending. |
filter.invalid_regex |
This pattern is not supported. |
filter.limit_reached |
You reached your filter limit. |
HTTP 429
mailbox.quota_exceeded |
You reached your mailbox limit. |
rate_limit.exceeded |
Too many requests. Try again in {seconds}s. |
HTTP 500
internal.error |
Server error. Support reference: {traceId} |