service_unavailable

HTTP 503 — The service is temporarily unavailable.

Returned as application/problem+json with code service_unavailable and HTTP status 503.

The service is temporarily unable to handle the request.

Common causes

  • Maintenance or overload.
  • An upstream circuit breaker is open.

How to resolve

  • Retry after a short delay with backoff.

Example

1{
2 "type": "https://docs.usglobalmail.com/api/problems/service_unavailable",
3 "title": "The service is temporarily unavailable.",
4 "status": 503,
5 "code": "service_unavailable",
6 "request_id": "req_8f3c2a1b9d",
7 "instance": "/v1/mails"
8}
This error is typically transient — safe to retry with exponential backoff.