Skip to main content

​
Service Unavailable

Service Unavailable

​
type
string
https://docs.username.dev/errors/service-unavailable
​
status
integer
503
​
When it occurs
The service is temporarily unavailable. This is rare and typically occurs during:
  • Planned maintenance windows
  • Unexpected infrastructure issues
  • Temporary service disruptions
​
How to fix
  1. Retry your request after a brief delay (30-60 seconds)
  2. Check the system status page for ongoing incidents
  3. The API may return cached responses when available, so retries might succeed even during partial outages
{
  "type": "https://docs.username.dev/errors/service-unavailable",
  "title": "Service Unavailable",
  "status": 503,
  "detail": "Service temporarily unavailable. Using cached response.",
  "instance": "/check?input=test"
}
Service unavailability is extremely rare due to Cloudflare’s global edge network. If you encounter this error, it’s likely temporary and will resolve quickly.
Example scenario: Temporary infrastructure issue or planned maintenance window.