Cloudflare Error Reference

1 model · 15 error codes

Browse Cloudflare error code collections, meanings, and related context across the current corpus.

About Cloudflare Error Reference

Cloudflare is a global edge network that operates as a reverse proxy between visitors and origin servers. Every request passes through Cloudflare's proxy layer before reaching the origin, which means Cloudflare observes both the visitor-to-edge path and the edge-to-origin path. When the origin is unreachable, returns malformed data, or fails security checks, Cloudflare generates its own error codes that do not exist in the HTTP specification.

Cloudflare errors fall into two families that serve different diagnostic purposes. The 5xx family (520–527) signals failures on the edge-to-origin path: the origin responded with something unexpected, refused the TCP connection, timed out, or had SSL handshake problems. The 1xxx family (1000–1020) signals failures at the edge itself: DNS resolution, WAF blocks, rate limiting, and Worker runtime errors. Neither family is defined by RFC 9110, and both require knowledge of the Cloudflare proxy architecture to interpret correctly.

FixerCode documents 15 Cloudflare error codes across 1 model. The reference covers the full edge-to-origin failure surface, from connection establishment problems (521–524) to SSL handshake failures (525–527) to edge-level access controls (1015, 1020). Each entry explains what Cloudflare measured, what the origin or client did, and how the code differs from its closest standard HTTP equivalent.

Select Your Model 1

Frequently Asked Questions

Cloudflare sits between visitors and origin servers as a reverse proxy. When the edge cannot reach the origin or the origin returns an invalid response, Cloudflare generates its own error codes instead of forwarding standard HTTP errors. This means a Cloudflare 5xx code describes the edge-to-origin path, not the application's own error handling.

No. Cloudflare's 5xx codes (520–527) and 1xxx codes (1000–1020) are proprietary to Cloudflare's edge network. They do not appear in RFC 9110 or any IETF standard. Other CDNs define their own edge-specific codes with different semantics, so a 522 on Cloudflare does not necessarily mean the same thing on a different CDN.

The origin server itself produces standard HTTP 5xx codes (500–505), and these describe application-level failures. Cloudflare 5xx codes (520–527) describe failures in the connection between Cloudflare's edge and the origin. A 502 from the origin means the origin's own gateway failed, while a 522 from Cloudflare means Cloudflare could not even establish a TCP connection to the origin.