[Blog](https://scrapfly.io/blog) / [http](https://scrapfly.io/blog/tag/http) / [What is HTTP 422 Error? (Unprocessable Entity)](https://scrapfly.io/blog/posts/what-is-http-422-error-unprocessable-entity) # What is HTTP 422 Error? (Unprocessable Entity) by [Mostafa](https://scrapfly.io/blog/author/mostafa) Apr 01, 2026 6 min read [\#http](https://scrapfly.io/blog/tag/http) [ ](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fscrapfly.io%2Fblog%2Fposts%2Fwhat-is-http-422-error-unprocessable-entity "Share on LinkedIn") ## What is HTTP Error 422? HTTP error 422 `Unprocessable Entity` occurs when the server understands the request but finds that the content is syntactically correct, yet semantically invalid. Essentially, the data you're submitting may be well-formed, but something about it is incorrect or incomplete, making it impossible for the server to process. ## Key Takeaways Fix HTTP 422 "Unprocessable Entity" errors by ensuring all required fields are present, data formats match server expectations, and validation rules are met to successfully process POST/PUT requests and form submissions. - HTTP 422 "Unprocessable Entity" occurs when server understands the request but finds the data semantically invalid - Common causes include missing required fields, invalid data formats, or values that don't meet server validation rules - POST/PUT requests are most likely to trigger 422 errors when submitting form data, JSON, or XML - Data validation is crucial - ensure all required fields are present and data types match server expectations - Format precision matters - exact JSON structure, proper escaping, and correct indentation can affect processing - Browser Developer Tools help inspect how websites format data to replicate exact behavior - Potential blocking - 422 errors on GET requests may indicate deliberate server blocking - Debugging approach - test with different data formats and use proxy rotation to isolate the issue **Get web scraping tips in your inbox**Trusted by 100K+ developers and 30K+ enterprises. Unsubscribe anytime. ## What are HTTP 422 Error Causes? The primary cause of a 422 error code is sending data that, while properly formatted, is not valid according to the server's expectations. This often happens with `POST` requests when submitting **form data, JSON, or XML that contain formatting errors**. For example, submitting a invalid or even a well-formed JSON document that lacks required fields or contains invalid values could trigger a 422 error. It’s important to ensure that the content being sent matches the server’s requirements, such as validation rules, data types, or required fields, to avoid this error. ## Practical Example To demonstrate how a server might return an HTTP 422 status code, let's build a simple [Flask](https://pypi.org/project/Flask/) API with a `/submit` endpoint that accepts `POST` requests. This example mimics submitting data to an API and returns a 422 error when the submitted data does not meet the server's validation rules (e.g., invalid email format). python```python from flask import Flask, jsonify, request app = Flask(__name__) # A simple validation function to check for a valid email format def is_valid_email(email): return "@" in email and "." in email @app.route("/submit", methods=["POST"]) def submit(): data = request.json email = data.get("email") # Check if email is provided and valid if not email or not is_valid_email(email): # Unprocessable Entity: Invalid email format return jsonify({"error": "Invalid email format."}), 422 # Otherwise, process the request return jsonify({"message": "Data submitted successfully."}), 201 if __name__ == "__main__": app.run(debug=True) ``` In the example above, we simulate a `/submit` endpoint that accepts `POST` requests containing JSON data. The server expects a valid email address in the request. If the email is missing or does not meet the simple validation check (containing "@" and "."), the server returns a 422 error, indicating the request is well-formed but semantically incorrect (i.e., invalid email). If the email is valid, the server processes the request and returns a success message. We can test this server with a http client: Python (httpx) Javascript (fetch) cURL python```python import httpx # Test successful submission with a valid email response = httpx.post("http://127.0.0.1:5000/submit", json={"email": "valid@example.com"}) print(f"Successful Submission: {response.status_code}, {response.json()}") # Test failed submission with an invalid email response = httpx.post("http://127.0.0.1:5000/submit", json={"email": "invalid-email"}) print(f"Failed Submission: {response.status_code}, {response.json()}") ``` javascript```javascript // Test successful submission with a valid email fetch("http://127.0.0.1:5000/submit", { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ email: "valid@example.com" }), }) .then(response => response.json().then(data => console.log("Successful Submission:", response.status, data))) .catch(error => console.error("Error:", error)); // Test failed submission with an invalid email fetch("http://127.0.0.1:5000/submit", { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ email: "invalid-email" }), }) .then(response => response.json().then(data => console.log("Failed Submission:", response.status, data))) .catch(error => console.error("Error:", error)); ``` shell```shell # Test successful submission with a valid email curl -X POST http://127.0.0.1:5000/submit -H "Content-Type: application/json" -d '{"email": "valid@example.com"}' # Test failed submission with an invalid email curl -X POST http://127.0.0.1:5000/submit -H "Content-Type: application/json" -d '{"email": "invalid-email"}' ``` ## 422 in Web Scraping In web scraping 422 http code is usually encountered when an error is made in `POST` or `PUT` data generation. So, ensure that posted data is of valid format be it JSON, HTML or XML to avoid this error. Furthermore, as scrapers don't know exactly how server is reading the received data it can be difficult to debug the exact cause. For this [Browser Developer Tools](https://scrapfly.io/blog/answers/browser-developer-tools-in-web-scraping) can be used to inspect exactly how a website formats the data like symbol escaping, indentation etc all of which can play a part in data processing. Replicating the exact behavior will decrease chances of encountering http status 422 while scraping. The 422 error could also mean that the server is blocking your requests deliberitely returning a 422 status code to signal that you are not allowed to access the resource. If you're receiving this status code on `GET` type request then that could be a sign of blocking. ## Power Up with Scrapfly ScrapFly provides [web scraping](https://scrapfly.io/docs/scrape-api/getting-started), [screenshot](https://scrapfly.io/docs/screenshot-api/getting-started), and [extraction](https://scrapfly.io/docs/extraction-api/getting-started) APIs for data collection at scale. - [Anti-bot protection bypass](https://scrapfly.io/docs/scrape-api/anti-scraping-protection) - scrape web pages without blocking! - [Rotating residential proxies](https://scrapfly.io/docs/scrape-api/proxy) - prevent IP address and geographic blocks. - [JavaScript rendering](https://scrapfly.io/docs/scrape-api/javascript-rendering) - scrape dynamic web pages through cloud browsers. - [Full browser automation](https://scrapfly.io/docs/scrape-api/javascript-scenario) - control browsers to scroll, input and click on objects. - [Format conversion](https://scrapfly.io/docs/scrape-api/getting-started#api_param_format) - scrape as HTML, JSON, Text, or Markdown. - [Full screenshot customization](https://scrapfly.io/docs/screenshot-api/getting-started#api_param_capture) - scroll and capture exact areas. - [Comprehensive options](https://scrapfly.io/docs/screenshot-api/getting-started) - block banners, use dark mode, and more. - [LLM prompts](https://scrapfly.io/docs/extraction-api/llm-prompt) - extract data or ask questions using LLMs - [Extraction models](https://scrapfly.io/docs/extraction-api/automatic-ai) - automatically find objects like products, articles, jobs, and more. - [Extraction templates](https://scrapfly.io/docs/extraction-api/rules-and-template) - extract data using your own specification. - [Python](https://scrapfly.io/docs/sdk/python) and [Typescript](https://scrapfly.io/docs/sdk/typescript) SDKs, as well as [Scrapy](https://scrapfly.io/docs/sdk/scrapy) and [no-code tool integrations](https://scrapfly.io/docs/integration/getting-started). ## FAQ How can I debug a 422 error when scraping a website?Start by using [Browser Developer Tools](https://scrapfly.io/blog/answers/browser-developer-tools-in-web-scraping) to inspect the exact request format the website expects, including headers, JSON structure, and field names. Compare your scraper's request payload against the browser's request to find discrepancies. ## Summary HTTP 422 errors typically result from submitting well-formed but invalid data, often in POST requests. While it's unlikely that 422 errors are used to block scrapers, it's always best to test with rotating proxies if the issue persists. Using Scrapfly's advanced tools, you can bypass these potential blocks and ensure your tasks continue without disruption. Table of Contents- [What is HTTP Error 422?](#what-is-http-error-422) - [Key Takeaways](#key-takeaways) - [What are HTTP 422 Error Causes?](#what-are-http-422-error-causes) - [Practical Example](#practical-example) - [422 in Web Scraping](#422-in-web-scraping) - [Power Up with Scrapfly](#power-up-with-scrapfly) - [FAQ](#faq) - [Summary](#summary) Join the Newsletter Get monthly web scraping insights Scale Your Web Scraping Anti-bot bypass, browser rendering, and rotating proxies, all in one API. Start with 1,000 free credits. No credit card required 1,000 free API credits Anti-bot bypass included [Start Free](https://scrapfly.io/register) [View Docs](https://scrapfly.io/docs/onboarding) Not ready? Get our newsletter instead. ## Explore this Article with AI [ ChatGPT ](https://chat.openai.com/?q=Summarize%20this%20page%3A%20https%3A%2F%2Fscrapfly.io%2Fblog%2Fposts%2Fwhat-is-http-422-error-unprocessable-entity) [ Gemini ](https://www.google.com/search?udm=50&aep=11&q=Summarize%20this%20page%3A%20https%3A%2F%2Fscrapfly.io%2Fblog%2Fposts%2Fwhat-is-http-422-error-unprocessable-entity) [ Grok ](https://x.com/i/grok?text=Summarize%20this%20page%3A%20https%3A%2F%2Fscrapfly.io%2Fblog%2Fposts%2Fwhat-is-http-422-error-unprocessable-entity) [ Perplexity ](https://www.perplexity.ai/search/new?q=Summarize%20this%20page%3A%20https%3A%2F%2Fscrapfly.io%2Fblog%2Fposts%2Fwhat-is-http-422-error-unprocessable-entity) [ Claude ](https://claude.ai/new?q=Summarize%20this%20page%3A%20https%3A%2F%2Fscrapfly.io%2Fblog%2Fposts%2Fwhat-is-http-422-error-unprocessable-entity) ## Related Articles [ http ### What is HTTP 413 Error? (Payload Too Large) HTTP status code 413 generally means that POST or PUT data is too large. Let's take a look at how to handle this. ](https://scrapfly.io/blog/posts/http-error-413-payload-too-large) [ curl ### How to Use cURL GET Requests Here's everything you need to know about cURL GET requests and some common pitfalls you should avoid. ](https://scrapfly.io/blog/posts/how-to-use-curl-get-requests) [ http ### What is HTTP 401 Error and How to Fix it Discover the HTTP 401 error meaning, its causes, and solutions in this comprehensive guide. Learn how 401 unauthorized e... ](https://scrapfly.io/blog/posts/what-is-http-401-error-and-how-to-fix-it) ## Related Questions - [ Q How to fix Python requests MissingSchema error? ](https://scrapfly.io/blog/answers/python-requests-exception-missingschema) - [ Q Web scraping - what is HTTP 403 status code? ](https://scrapfly.io/blog/answers/403-status-code) - [ Q How to fix Python requests ReadTimeout error? ](https://scrapfly.io/blog/answers/python-requests-exception-readtimeout) - [ Q How to fix Python requests SSLError? ](https://scrapfly.io/blog/answers/python-requests-exception-sllerror) Scale your web scraping effortlessly, **1,000 free credits** [Start Free](https://scrapfly.io/register)