Icanhazip
Returns the caller's public IP address via simple HTTPS request.
Read docs Updated 2026-06-17
What is Icanhazip?
Icanhazip is a minimal public API endpoint that echoes the client's external IP address detected by the server.
It is useful for scripts, containers, network tools, and applications that need to discover their public IP without added dependencies or credentials.
What you can build with Icanhazip
Dynamic DNS record updates
Scripts periodically query the API to detect public IP changes and automatically update DNS records for home servers or IoT devices.
Network diagnostic tools
Command-line utilities and monitoring dashboards fetch the current egress IP to verify VPN tunnels, proxy configurations, or NAT behavior.
Automated deployment checks
CI/CD pipelines or server bootstrap scripts confirm the instance's public IP matches expected allow-lists before proceeding with configuration.
Get started with Icanhazip
- 1Make a GET request to https://ipv4.icanhazip.com or https://ipv6.icanhazip.com
- 2Read the plain-text response body which contains only the IP address
- 3Parse the response in your language or script of choice
- 4Add error handling for network failures or unexpected responses
- 5Cache or rate-limit calls if running frequently to avoid unnecessary load
Icanhazip: pros & cons
Pros
- +No authentication or sign-up required
- +Returns clean plain text with nothing extra
- +Supports both IPv4 and IPv6 endpoints over HTTPS
- +Extremely lightweight and fast to integrate
Cons
- –Provides only the IP address with no geolocation or metadata
- –Relies on a single third-party service
- –No official SLA or guaranteed uptime
Did you find this helpful?
Frequently asked questions
A minimal public service that returns your current public IP address in plain text when accessed via HTTP or HTTPS.
User reviews
Verified reviews from the community shape this listing's rating.
Loading reviews…
Similar APIs
Other developer tools options worth comparing.