Built by Abstract: powerful API's for every use case.
Learn more 🚀

HTTP Status Code
422 - Unprocessable Entity

4xx Client errors

The HTTP Status Code 422 means that request was well-formed but was unable to be followed due to semantic errors.

What is HTTP Status Code 422?

The Role of HTTP and Status Codes

The Hypertext Transfer Protocol (HTTP), a foundation of data communication on the World Wide Web, leverages HTTP status codes to communicate the outcome of the processing of an HTTP request. Among the sea of these status codes, HTTP status code 422 holds a unique place.

Understanding HTTP Status Code 422

HTTP status code 422, also known as the "Unprocessable Entity" status code, signifies that the server understands the content type of the request entity, but was unable to process the contained instructions. This status code is part of the HTTP extensions for Web Distributed Authoring (WebDAV), an extension of HTTP that allows clients to perform remote web content authoring operations.

Differentiating Status Codes

The HTTP status code 422 is distinct from the Bad Request status code (400). The latter signifies a generic client-side error, with the server failing to understand the request due to malformed syntax. On the other hand, a 422 status code implies that the server comprehends the content type of the request entity (with the syntax being correct), but was unable to process the contained instructions.

Status Codes in Programming Languages

In many programming languages and frameworks, HTTP status codes have associated symbols and constants for easier usage. For example, in Ruby on Rails, the HTTP status symbol for 422 is `:unprocessable_entity`. Similarly, in Symfony, the HTTP status constant for 422 is `Response::HTTP_UNPROCESSABLE_ENTITY`.

When and How is HTTP Status Code 422 used?

Typical Use Cases

The 422 Unprocessable Entity status code is typically used in the context of web services, where the server cannot understand the request due to issues like a semantic error in the request body. A semantic error implies that while the syntax of the XML request body might be correct, the semantics, i.e., the meaning of the XML instructions, are not understandable by the server.

Understanding Semantic Errors

Semantic errors are common issues when working with XML data. They occur when the server is unable to understand the meaning of the data due to incorrect semantics, even though the syntax is correct. Examples include XML instructions that require the server to perform an operation it can't, or contain contradictory instructions.

Preventing and Troubleshooting Errors

To avoid a 422 Unprocessable Entity error, it's essential to ensure the semantics of the XML instructions in the request body are correct. Rigorous testing and validation of XML data before sending it to the server are often involved in this process.

Just as with other HTTP status codes, a 422 status code means that a specific type of error has occurred. This error code is crucial in troubleshooting the problem and fixing it. An error message in the response body provides insights into the nature of the error and possible remedies.

Status Codes in Different Frameworks

In the Symfony framework, you would use the Symfony HTTP status constant `Response::HTTP_UNPROCESSABLE_ENTITY` to denote a 422 status code. This built-in constant in the Symfony Response class corresponds to the 422 Unprocessable Entity status code, making your code more readable and easier to maintain.

As such, HTTP status code 422 is a vital part of the HTTP extensions for Web Distributed Authoring. It finds its main use case in situations where the server cannot process the instructions in a request entity due to semantic errors. By understanding what this status code means and when it's used, developers can more effectively debug and resolve issues that arise during the development process.

Example usage of HTTP Status Code 422

Simplified Example

Let's take a common scenario that many of us have likely encountered online. You're filling out a web form, maybe to sign up for a new social media account or to purchase something from an online store. You've carefully input all of your information, and you confidently hit the 'Submit' button, expecting to be taken to the next page. However, instead of progressing, you're met with an error message.

This could be the result of an HTTP status code 422, also known as an Unprocessable Entity status. In layman's terms, the server understood the 'language' of the data you sent—it was syntactically correct—but there was a semantic error in the data that prevented it from being processed properly. It's akin to writing a grammatically correct sentence in a language that the recipient understands, but the sentence doesn't make sense within the given context.

A More Technical Perspective

For those with a more technical background, let's consider an example involving a POST request to an API endpoint. This endpoint might be responsible for creating a new user in a database. The request entity—i.e., the information sent to the server—includes a user's name, email, and password. The server expects these values to meet certain conditions, such as the email being in a valid format.

However, let's say that the email field contains an invalid email address. Even though the server can understand the type of data sent (it's valid JSON), it cannot process the information due to the invalid email. This semantic error prompts the server to return an HTTP 422 status code.

const axios = require('axios');

const user = {
  name: 'John Doe',
  email: 'invalid email',
  password: 'password123'

axios.post('/api/users', user)
  .catch(error => {
    if (error.response.status === 422) {
      console.error('Unprocessable Entity: ', error.response.data);

In this JavaScript code snippet, we use the axios library to send a POST request to the '/api/users' endpoint. If the server responds with a 422 status code, an error message is logged to the console, offering valuable insights for debugging the issue.

What is the history of HTTP Status Code 422?

The 422 Unprocessable Entity status code has an interesting history. It emerged from the Hypertext Transfer Protocol (HTTP) extensions for Web Distributed Authoring and Versioning (WebDAV). The WebDAV extensions were designed to enable users to collaboratively edit and manage files on remote servers. As such, they required additional HTTP methods and status codes to handle specific situations not covered by the standard HTTP protocol.

The 422 status code was introduced to handle situations where the server was able to understand the type and syntax of a request entity but was unable to process the contained instructions due to semantic errors. This was particularly useful in situations where a request entity was well-formed, but the instructions contained within were semantically incorrect.

How does HTTP Status Code 422 relate to other status codes?

Comparison with 400 and 415

HTTP status code 422 often draws comparisons with two other status codes—400 and 415. The 400 status code, also known as 'Bad Request', is traditionally used when the server could not understand the request due to malformed syntax. However, following updates in RFC 7231, the 400 status code's scope has been broadened to include any situation where the server perceives a client error, even if the request syntax is valid.

The 415 status code, 'Unsupported Media Type', is used when the server refuses to accept the request because the request entity is in a format not supported by the requested resource.

However, the 422 status code is unique. It is used when the server understands the content type of the request entity, and the syntax of the request entity is correct, but it is unable to process the contained instructions due to semantic errors.

The 422 Advantage

Consider an example where a user submits a password that meets all syntactical requirements, but uses a blacklisted string, such as "password". While the server recognizes the data's format and understands the request, it refuses to process the data due to the semantically erroneous input. In this case, using a 422 status code provides a more accurate representation of the issue, compared to a 400 Bad Request or a 415 Unsupported Media Type.

The use of the 422 status code has become more prevalent in popular APIs, providing more granular error reporting. It serves as a valuable tool for situations where the data is understood but is still not valid. The HTTP status code 422 truly fills a unique niche in HTTP status codes. It helps provide specific feedback about semantic errors in request entities, thus contributing to the robustness and specificity of HTTP as a whole. This nuanced status code is a testament to the ongoing evolution of HTTP, adapting to the requirements of a diverse and evolving internet landscape.

Other interesting things to know about HTTP Status Code 422

A Brief Perspective

Often, the HTTP Status Code 422 is linked to WebDAV (Web Distributed Authoring and Versioning) operations, a set of extensions for HTTP that allow clients to perform remote web content authoring operations. It's an interesting facet to note, considering the status code's purpose of handling semantic errors in request formation.

HTTP Status Code 422 and GET Requests

There's been a long-standing discussion in the developer community about the applicability of the 422 status code for GET requests. Conventionally, 422 is used for request methods that can have a request body, like POST and PUT. However, there's no explicit rule stating that it can't be used for GET requests. It's uncharted territory, and the practices vary across different software teams.

Comparison with HTTP 409 Conflict

Lastly, an intriguing comparison can be drawn between HTTP 422 and HTTP 409 Conflict. While they may seem similar, there's a subtle difference. The 409 status code indicates a conflict based on the current state of the target resource, which can be resolved by the user. On the other hand, 422 signifies that the request was semantically erroneous and should not be retried without modification. The distinction might seem nuanced but is crucial in the world of web development, highlighting the preciseness of HTTP status codes.

Additional Links and Codes Related to Status Code 422

Written by Benjamin Bouchet.
Last updated Jul 26, 2023.