Cloudflare Trace
Retrieve client IP, location, user agent, and protocol details.
Read docs Updated 2026-06-16
What is Cloudflare Trace?
Cloudflare Trace is a public endpoint that exposes connection metadata collected by Cloudflare's network for each request.
It is useful for developers who need to inspect client IP addresses, geolocation indicators, or protocol versions during debugging and testing.
What you can build with Cloudflare Trace
Client IP logging
Record the actual visitor IP address in server logs for applications sitting behind Cloudflare's proxy.
Basic geolocation checks
Read the country code to apply simple region-based logic such as content notices or access rules.
Protocol debugging
Inspect HTTP version and TLS cipher details when troubleshooting client connectivity or compliance issues.
Get started with Cloudflare Trace
- 1Send an HTTPS GET request to the Cloudflare trace endpoint
- 2Receive the plain-text key-value response
- 3Parse fields such as ip, loc, http, and tls in your code
- 4Store or act on the returned values inside your application
- 5Repeat the request from different clients to observe variations
Cloudflare Trace: pros & cons
Pros
- +No authentication or keys needed
- +Works over standard HTTPS
- +Returns useful request metadata in one call
- +Zero cost for any Cloudflare-routed traffic
Cons
- –Only available when traffic passes through Cloudflare
- –Plain-text format requires manual parsing
- –Provides only static snapshot data per request
Did you find this helpful?
Frequently asked questions
An endpoint that returns metadata about an incoming HTTP request such as client IP, country, user agent, and protocol versions.
User reviews
Verified reviews from the community shape this listing's rating.
Loading reviews…
Similar APIs
Other developer tools options worth comparing.