503 Service Unavailable

noun

say it: “FYVE-oh-THREE SUR-vis un-uh-VAY-luh-bul” /faɪv oʊ θri ˈsɝvɪs ˌʌnəˈveɪləbəl/

An HTTP status code saying the server can't handle requests at the moment, usually for a short time.

What is 503 Service Unavailable?

503 Service Unavailable says the server can't take requests right now, such as when its database isn't answering or it's shutting down. Unlike a 500, it means "try again soon", and a Retry-After header can say when.

res.status(503).set("Retry-After", "30").json({ status: "database unavailable" });

In a sentence

  • “A 503 Service Unavailable during a deploy tells the host to wait before sending traffic.”
  • “While the database restarted, the health check answered 503 Service Unavailable.”

Level: Journeyman · More REST API terms at this level

Updated