M
API Matrix

Icanhazip API

⭐ Beginner's Pick Development / No Auth Required Beginner HTTPS CORS
Free to Use Varies (check documentation)
87 Score
Grade A
Visit Official Site Compare Alternatives

Overview

Icanhazip returns your public IP address as a plain text string with no authentication, parsing, or configuration needed. It is one of the oldest and most widely used IP detection services, commonly embedded in shell scripts and network configuration tools. Both IPv4 (icanhazip.com) and IPv6 (ipv6.icanhazip.com) variants are available.

💡

Beginner Tip

Just curl the URL and you get your IP address back as plain text — it is that simple. This is an ideal first API call for anyone new to curl or HTTP. Use it in shell scripts with MY_IP=$(curl -s https://icanhazip.com) to capture your current public IP into a variable.

Available Data

IP address information
geographic location
ASN and ISP data
Use case: Integrate ip address api data into web and mobile applications

Example Response

JSON Response 
{
  "status": "success",
  "data": {
    "result": "Data from Icanhazip",
    "description": "IP Address API",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

(plain text body) Your public IP address as a plain text string, either IPv4 or IPv6 depending on your network stack.

Implementation Example 

const url = "https://major.io/icanhazip-com-faq/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Returns IPv6 address unexpectedly Your machine prefers IPv6 and the resolver returns AAAA records
✓ Use curl -4 https://icanhazip.com to force IPv4, or use https://ipv4.icanhazip.com explicitly.
Trailing newline in response The API appends a newline character after the IP
✓ Trim the response: in bash use $(curl -s https://icanhazip.com | tr -d newline).
429 rate limit Too many requests from the same IP in a short time
✓ Add delays between requests; for high-frequency use consider ipify.org which has a more generous rate limit.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 20/20
✓ Reliability 7/15
Response Time 244ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS YES
Category Development
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →

24 Pull Requests

⭐ Beginner's Pick
87

24 Pull Requests is a community initiative that runs every December to encourage developers to contribute to open source projects.

No Auth Beginner HTTPS 228ms

Agify.io

⭐ Beginner's Pick
82

Agify.io is a free API that predicts the likely age of a person based solely on their first name, using a database of over 350 million historical records.

No Auth Beginner HTTPS 529ms

API Grátis

57

API Grátis is a Brazilian API aggregator that bundles multiple free utility services including CEP (postal code) lookup, CNPJ (company registry) data, vehicle plate information, and more — all under a single authentication token.

No Auth Beginner HTTPS 44ms

ApicAgent

⭐ Beginner's Pick
92

ApicAgent parses User-Agent strings into structured device and browser information, returning details like browser name, version, OS, device type, and whether the client is a bot.

No Auth Beginner HTTPS 109ms

APIs.guru

⭐ Beginner's Pick
87

APIs.guru maintains a crowd-sourced directory of OpenAPI (Swagger) specification files for hundreds of public web APIs, all normalized to OpenAPI 3.0 format.

No Auth Beginner HTTPS 146ms