Free Public API

API Documentation

Free, no-authentication JSON (and plain-text) API that returns the caller’s public IP address and reverse DNS hostname.

GET Base endpoint

https://directip.info/api/

Quick start

# Full information (JSON)
curl https://directip.info/api/

# Expanded information
curl https://directip.info/api/?expanded=true

# IPv4 only
curl https://directip.info/api/?type=ipv4

# IPv6 only
curl https://directip.info/api/?type=ipv6

# Plain text IP (ipify-style)
curl https://directip.info/api/?format=text

Query parameters

Parameter	Values	Description
`type`	`all`, `ipv4`, `ipv6`	Which address family to return
`format`	`json`, `text`	Response format
`hostname`	`1` or `0`	Include reverse DNS lookup
`expanded`	`true` or `1`	Return geo, ISP, ASN, city, coordinates, timezone

Example responses

Full response (?type=all)

{
  "success": true,
  "ipv4": "203.0.113.42",
  "ipv6": null,
  "hostname_v4": "customer.example.net",
  "hostname_v6": null,
  "user_agent": "curl/8.5.0",
  "note": "A single request only reveals the protocol used to reach the server..."
}

Expanded response (?expanded=true)

{
    "success": true,
    "ip": "203.0.113.42",
    "version": 4,
    "hostname": "customer.example.net",
    "city": "Austin",
    "region": "Texas",
    "region_code": "TX",
    "country": "United States",
    "country_code": "US",
    "zip": "02108",
    "lat": 42.3588,
    "lon": -71.0638
    "timezone": "America/Chicago",
    "isp": "Charter Communications",
    "org": "Spectrum",
    "as": "AS11427 Charter Communications Inc",
    "asname": "TWC-11427-TEXAS",
    "mobile": false,
    "proxy": false,
    "hosting": false,
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36"
}

IPv4 only(?type=ipv4)

{
  "success": true,
  "ipv4": "203.0.113.42",
  "hostname": "customer.example.net"
}

Plain text (?format=text)

203.0.113.42

Important notes

No API key or authentication is required.
CORS is enabled (Access-Control-Allow-Origin: *) so you can call the API from browsers.
A single HTTP request can only reveal the address family used to connect (IPv4 or IPv6). To obtain both addresses, make two requests — one over IPv4 and one over IPv6.
Reverse DNS (PTR) records are not always published by ISPs; the hostname field may be null.
Please be reasonable with request volume. This is a free service. A rate limit of 25 requests per minute applies.

JavaScript example

fetch('https://directip.info/api/')
  .then(r => r.json())
  .then(data => {
    console.log('Your IP:', data.ipv4 || data.ipv6);
    console.log('Hostname:', data.hostname_v4 || data.hostname_v6);
  });

Port Check API

Test whether a TCP port is open on a public IP address or hostname. This is the same service that powers the Port Checker page.

GET https://directip.info/api/portcheck/?port=443
GET https://directip.info/api/portcheck/?port=25565&ip=203.0.113.9
GET https://directip.info/api/portcheck/?port=22&ip=example.com

port (required): a number from 1 to 65535.
ip (optional): a public IPv4 address, IPv6 address or hostname. Defaults to your own IP.
status in the response is open, closed (connection refused) or filtered (no response, usually a firewall).
TCP only. Private, local and reserved addresses are refused.
Rate limit: 10 checks per minute and 60 per hour per caller.

{
  "success": true,
  "ip": "203.0.113.9",
  "hostname": null,
  "port": 25565,
  "protocol": "tcp",
  "service": "Minecraft Java",
  "status": "open",
  "open": true,
  "latency_ms": 41,
  "message": "Port 25565 is open on 203.0.113.9.",
  "checked_at": "2026-10-26T14:30:00+00:00"
}

Support

Questions or feedback? Use the Contact us button on the homepage.