---
description: All possible proxyStatus values for Privacy Proxy error classification in GraphQL Analytics and OpenTelemetry metrics.
title: Proxy status reference
image: https://developers.cloudflare.com/og-docs.png
---

[Skip to content](#main-content)

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/privacy-proxy/llms.txt  
> Use this file to discover all available pages before exploring further.

# Proxy status reference

Last updated Sep 1, 2026|Copy as Markdown| [View as Markdown](https://0285ca83.previews.developers.cloudflare.com/privacy-proxy/reference/proxy-status/index.md)| [Agent setup](https://0285ca83.previews.developers.cloudflare.com/agent-setup/)

The `proxyStatus` dimension provides proxy-level error classification. This field is available in both [GraphQL Analytics API](https://0285ca83.previews.developers.cloudflare.com/privacy-proxy/reference/metrics/graphql/) and [OpenTelemetry](https://0285ca83.previews.developers.cloudflare.com/privacy-proxy/reference/metrics/opentelemetry/) metrics. The value is an empty string when no proxy-level error occurred.

---

## `proxyStatus` values

| Value | Description |
| --- | --- |
| `dns_error` | The proxy encountered a DNS error when resolving the next hop hostname. |
| `dns_timeout` | The proxy timed out while resolving the next hop hostname. |
| `destination_not_found` | The proxy cannot determine the appropriate next hop for this request. |
| `destination_unavailable` | The proxy considers the next hop unavailable (for example, recent failures or health check is down). |
| `destination_ip_prohibited` | The proxy is configured to prohibit connections to the next hop IP address. |
| `destination_ip_unroutable` | The proxy cannot find a route to the next hop IP address. |
| `connection_refused` | The proxy's connection to the next hop was refused. |
| `connection_terminated` | The proxy's connection to the next hop was closed before any response was received. |
| `connection_timeout` | The proxy's attempt to open a connection to the next hop timed out. |
| `connection_read_timeout` | The proxy was expecting data on a connection but received none within the configured time limit. |
| `connection_write_timeout` | The proxy was attempting to write data to a connection but was unable to. |
| `connection_limit_reached` | The proxy's configured connection limit to the next hop has been exceeded. |
| `source_addr_in_use` | The proxy cannot assign a source address when connecting to the next hop. |
| `source_addr_not_available` | The proxy cannot assign a source address (bind failure or source host resolution failure). |
| `tls_protocol_error` | The proxy encountered a TLS error when communicating with the next hop. |
| `tls_certificate_error` | The proxy encountered an error verifying the certificate presented by the next hop. |
| `http_request_error` | The proxy is generating a client (4xx) response on the origin's behalf. |
| `http_upgrade_failed` | The HTTP Upgrade between the proxy and the next hop failed. |
| `http_request_denied` | The proxy rejected the HTTP request based on its configuration or policy. |
| `proxy_internal_error` | The proxy encountered an internal error unrelated to the origin. |
| `proxy_loop_detected` | The proxy tried to forward the request to itself. |
| `http_protocol_error` | The proxy encountered an HTTP protocol error when communicating with the next hop. |
| `http_response_incomplete` | The proxy received an incomplete response from the next hop. |
| `rate_limited` | The client has reached the maximum number of connections per second to a single origin. |

Was this helpful?

YesNo

## On this page

[![](https://0285ca83.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://0285ca83.previews.developers.cloudflare.com/)

```json
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/privacy-proxy/reference/proxy-status/#page","headline":"Proxy status reference · Cloudflare Privacy Proxy docs","description":"All possible proxyStatus values for Privacy Proxy error classification in GraphQL Analytics and OpenTelemetry metrics.","url":"https://developers.cloudflare.com/privacy-proxy/reference/proxy-status/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-09-01","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
```