Skip to content

422 Unprocessable Content ​

Meaning ​

The request was well-formed (syntactically correct) but the server cannot process it due to semantic errors.

When to Use ​

When the server understands the content type and syntax of the request entity, but it was unable to process the contained instructions. Often used for validation errors on a request that has the correct format but invalid data.

Example ​

POST /api/users with a JSON body that is syntactically correct but fails business logic validation (e.g., password too short) may result in 422 Unprocessable Content to indicate the semantic issues.

When Not to Use ​

Do not use for malformed requests (use 400) or authentication/authorization errors. 422 is for scenarios where the request is understood but cannot be processed because of logic or semantic problems.

Source ​

RFC 9110


Released under the MIT License.