Skip to content

503 Service Unavailable

Meaning

The server is currently unable to handle the request due to temporary overload or maintenance. This is usually a temporary state.

When to Use

When the server is down for maintenance or is overloaded and cannot handle requests at the moment. It indicates that the condition is likely temporary and the same request might succeed at a later time.

Example

If a website is undergoing scheduled maintenance, it may return 503 Service Unavailable with a message like 'We'll be back soon' and possibly a Retry-After header to tell clients when to try again.

When Not to Use

Do not use for permanent failures or unrecoverable server errors (500 series). 503 should not be used if the service is operational but the request itself is faulty (that would be a 4xx). It's specifically for temporary unavailability of the service itself.

Source

RFC 9110


Released under the MIT License.