The server is temporarily unable to handle the request — overloaded, or down for maintenance. Often accompanied by Retry-After.
Defined in RFC 9110 §15.6.4 — 503 Service Unavailable · MDN reference
Planned maintenance, a deploy in progress, a dependency that is down, or a load shedder deliberately turning traffic away to protect what is left.
Unlike a 500, a 503 is explicitly retryable. Test that your client treats them differently instead of collapsing both into "error".
Retry with backoff, and honour Retry-After when the server sends one — a 503 with a Retry-After is a server telling you precisely when to come back, and ignoring it is how a recovering service is pushed back over. Fail open or degrade gracefully where the call is not essential.
7 endpoints in this playground answer with 503. Every one is free, needs no signup, and can be called from the browser or with curl.
POST https://funapi.dev/api/auth/v1/firebase-token — Mint a Firebase Auth token whose role custom claim grants admin or viewer (Auth Playground API) Open & run this endpointGET https://funapi.dev/api/protocol/v1/maintenance — Scheduled maintenance — 503 + Retry-After (Protocol Lab API) Open & run this endpointGET https://funapi.dev/api/faults/v1/target — Call the configured flaky target (Fault Injection API) Open & run this endpointGET https://funapi.dev/api/faults/v1/status/{code} — Return any status code on demand (200–599) (Fault Injection API) Open & run this endpointPOST https://funapi.dev/api/llm/v1/chat/completions — Chat Completions shape: streaming (SSE), tools, JSON mode, failures by model (Mock LLM API) Open & run this endpointGET https://funapi.dev/api/weather/v1/current — Current conditions (deterministic per location and hour) (Weather API) Open & run this endpointGET https://funapi.dev/api/weather/v1/forecast — Daily forecast, 1–7 days (Weather API) Open & run this endpointAll HTTP status codes · All 55 mock REST APIs · Getting started guide
Last updated