Status Code 503

Service Unavailable

The server cannot handle the request because it is overloaded or down for maintenance.

Details

Category

Server Error

Popularity

common

Recommended

Yes

Deprecated

No

Common Use Case

Server maintenance, overload

Notes

Used to indicate that the server is temporarily unable to handle the request.

RFC Reference

RFC 9110 HTTP/1.1 (2022)
Defines the HTTP/1.1 protocol, including semantics, caching, and connection management.

Description

The server cannot handle the request because it is overloaded or down for maintenance.

HTTP Response Example

A typical server response for a 503 Service Unavailable status code looks like:

HTTP/1.1 503 Service Unavailable
Date: Sun, 22 Mar 2026 12:00:00 GMT
Server: httperrors.com
Content-Type: application/json

{
  "error": {
    "code": 503,
    "message": "Service Unavailable"
  }
}
Detailed Explanation

Server errors matter operationally because they affect reliability, user trust, retries, monitoring, and incident response. They should be treated as meaningful operational feedback rather than generic failure labels.

Historically, HTTP 503 Service Unavailable should be read in light of RFC 9110. Standards text tends to focus on precise semantics, while production systems care about retries, user experience, dashboards, proxies, browsers, and documentation. Good engineering joins those two views instead of choosing one over the other. When teams treat a status code as both a protocol message and a product decision, they produce APIs and pages that are easier to operate and easier to trust.

A practical reading of this entry is that the server is communicating something very specific: The server cannot handle the request because it is overloaded or down for maintenance. In day-to-day work, that meaning should be reflected across controllers, reverse proxies, API gateways, and frontend assumptions. If the server sends HTTP 503, but the response body, cache headers, or application behavior tell a different story, client code starts compensating for inconsistency and the whole stack becomes harder to reason about.

HTTP 503 Service Unavailable is not marked as deprecated, which means it remains relevant for current systems so long as its semantics map cleanly to the behavior your endpoint is actually delivering.

Server error responses should be paired with logging, tracing, and metrics. The status code is only the public symptom; operators still need enough internal observability to identify the real failure path.

In implementation terms, HTTP 503 Service Unavailable should appear at a deliberate decision point in your request handling code. Avoid choosing it late as a cosmetic label after the rest of the response is already formed. Clients may consider retry logic, but servers should still pair retries with idempotency safeguards and clear observability. If your logs show this status frequently, the surrounding context should make it obvious whether the response reflects normal traffic or a design problem.

The supporting note for this entry is also important: Used to indicate that the server is temporarily unable to handle the request. This often captures the gap between the formal specification and day-to-day engineering practice.

A useful way to compare HTTP 503 is against other 5xx responses that point to different failure domains. Grouping every incident under a generic server error makes it harder to reason about real reliability patterns. This is one reason protocol precision pays off over time: the better your status taxonomy, the easier it becomes to debug client behavior, build metrics, and explain edge cases to other engineers.

From an operational perspective, HTTP 503 should be visible in logs, metrics, and alerts with enough surrounding metadata to explain why it happened. Popularity for this entry is listed as common, and that should influence how much defensive documentation and monitoring you add. Because the code is common, it is worth distinguishing healthy uses from suspicious spikes so routine traffic is not mistaken for a regression.

Server error responses are one of the fastest ways to damage crawler confidence because they suggest instability on the origin. If they happen repeatedly, crawlers often reduce crawl frequency and may remove pages from the index until the failures stop. For HTTP 503, the operational takeaway is that status correctness supports SEO indirectly by making crawl behavior more predictable. Pages, APIs, and edge routes should return this code only when its meaning is exactly true.

Since this code is marked as recommended, teams can confidently use it when the semantics are an exact match. The key word is exact. Recommendation does not mean convenience; it means the code is a strong standard choice when the surrounding conditions line up.

Because this code is not deprecated, it remains part of the active vocabulary that modern web systems can use. Even so, correctness still depends on discipline. A valid status code becomes harmful if teams reuse it as shorthand for several unrelated situations.

The recommendation flag for this entry is positive, so teams should treat HTTP 503 as a code that is generally safe to use when the semantics match. This is especially relevant when designing a public API that must stay predictable over time.

The best way to think about HTTP 503 Service Unavailable is not as trivia, but as a promise. It tells the caller what happened, what should happen next, and how much confidence the client can place in the current response. The example recorded for this entry is Server maintenance, overload, and the note says Used to indicate that the server is temporarily unable to handle the request.. Together with the specification link at https://datatracker.ietf.org/doc/html/rfc9110#section-15.6.4, those details give implementers enough context to use the code intentionally rather than mechanically. That is the standard worth aiming for in production systems.

Other HTTP status codes in the Server Error category

500 Internal Server Error

A generic error message, given when an unexpected condition was encountered and no more specific message is suitable.

Reference: RFC 9110
Example usage:
Unhandled exceptions, server crashes
Server Error
501 Not Implemented

The server either does not recognize the request method, or it lacks the ability to fulfil the request.

Reference: RFC 9110
Example usage:
Unsupported HTTP methods
Server Error
502 Bad Gateway

The server was acting as a gateway or proxy and received an invalid response from the upstream server.

Reference: RFC 9110
Example usage:
Proxy/load balancer upstream errors
Server Error
504 Gateway Timeout

The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.

Reference: RFC 9110
Example usage:
Upstream server timeout
Server Error
505 HTTP Version Not Supported

The server does not support the HTTP protocol version used in the request.

Reference: RFC 9110
Example usage:
Client using unsupported HTTP version
Server Error
506 Variant Also Negotiates

Transparent content negotiation for the request results in a circular reference.

Reference: RFC 2295
Example usage:
Content negotiation configuration error
Server Error
507 Insufficient Storage

The server is unable to store the representation needed to complete the request.

Reference: RFC 4918
Example usage:
WebDAV server storage full
Server Error
508 Loop Detected

The server detected an infinite loop while processing the request.

Reference: RFC 5842
Example usage:
WebDAV binding loops
Server Error
510 Not Extended

Further extensions to the request are required for the server to fulfil it.

Reference: RFC 2774
Example usage:
HTTP Extension Framework
Server Error
511 Network Authentication Required

The client needs to authenticate to gain network access.

Reference: RFC 6585
Example usage:
Captive portal authentication
Server Error

HTTP status code data sourced from official IETF RFCs and standards.

© 2026 The open source reference for HTTP status codes