DevKits
414

URI Too Long

4xx Client Error

Last updated:

The URL exceeds the maximum length the server is willing to process.

Description

The server is refusing to service the request because the target URI is longer than the server's configured limit. Most commonly triggered by huge query strings (e.g. GET with deeply-nested filter params or multi-select lists). Browsers have their own URL limit too (~2,048 to 100,000 characters depending on browser), so this status is rare.

When to use

Return 414 when you enforce strict URL-length limits (e.g. < 2,048 chars for compatibility with IE-era proxies) and a request exceeds them. The client should switch to POST with the data in the body.

Specification

RFC 9110 §15.5.15

Examples

HTTP response
HTTP/1.1 414 URI Too Long
Content-Type: application/json

{"error":"URI Too Long"}
Node.js (Express)
res.status(414).json({ error: "URI Too Long" });
Go (net/http)
w.WriteHeader(http.Status414)
Python (Flask)
return jsonify({"error": "URI Too Long"}), 414

Debug 414 with these tools

Related status codes

All 4xx codes