HTTP 412 — Precondition Failed

The server does not meet one of the preconditions that the requester put on the request

When to use it

Use status 412 when this is the correct HTTP response semantic: The server does not meet one of the preconditions that the requester put on the request

Request and response example

GET /protected-resource HTTP/1.1
Host: api.example.com

HTTP/1.1 412 Precondition Failed
Content-Type: application/json

{"error":"Request cannot be completed"}

Related status codes

400, 401, 402, 403

References

MDN · RFC 9110