Skip to content
Last updated

Service Unavailable

HTTP Status: 503 Service Unavailable
RFC Reference: RFC 9110 Section 15.6.4

A required downstream service is currently unavailable.

Response

HTTP/1.1 503 Service Unavailable
Content-Type: application/problem+json
Retry-After: 60

{
  "type": "https://docs.apiera.io/problems/service-unavailable",
  "title": "Service Unavailable",
  "status": 503,
  "detail": "A required downstream service is currently unavailable. Please try again later.",
  "instance": "/v1/products",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000"
}

How to Handle

  1. Check the Retry-After header (60 seconds)
  2. Wait before retrying
  3. Implement exponential backoff for multiple failures

This is typically a temporary issue that resolves automatically.