IP Geolocation

What It Does

Resolves the physical location associated with an IP address using Cloudflare's geolocation database at the edge. Returns structured data including continent code, country (with ISO 3166-1 alpha-2 code), region/subdivision (ISO 3166-2), city, latitude/longitude coordinates, IANA timezone identifier, postal code where available, and the Autonomous System Number (ASN) with organization name operating the IP range. Also returns a `privacy` object flagging whether the IP is a known Tor exit node, falls within a published relay range (iCloud Private Relay, Cloudflare WARP), or belongs to a hosting / VPN ASN — useful for fraud detection and access-control gating without a second API call.

Why It's Useful

IP geolocation is foundational for fraud detection, content localization, GDPR/regulatory compliance, and user analytics. The bundled privacy classification answers the question every fraud team eventually asks — "is this even an end-user, or is it a Tor exit / VPN / datacenter?" — without paying a third-party privacy-detection vendor. It enables security engineers to detect impossible travel attacks and anonymized traffic, product teams to serve localized content and pricing, and compliance teams to enforce geographic access controls mandated by regulations like GDPR, CCPA, and data sovereignty laws.

Use Cases

Parameters

Response Fields

Code Examples

curl "https://api.edgedns.dev/v1/ip/geolocation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "ip=8.8.8.8"

const response = await fetch(
  'https://api.edgedns.dev/v1/ip/geolocation?ip=8.8.8.8',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.edgedns.dev/v1/ip/geolocation',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'ip': '8.8.8.8'
    }
)

data = response.json()
print(data)

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.