Service 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.

Check system status

A 503 is a server-side failure, so it may reflect a known incident rather than a problem with your request. Check the System status page — if there’s an open incident affecting the USGM API or USGM Core, the issue is on our side, so wait for it to resolve. If everything is operational and the error persists, contact support with your request_id.

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
}