# whatismyip.codes

> Free IP geolocation API. 7 endpoints, no API key, no signup, no nonsense. Just HTTPS and JSON.

## About
- Site: https://whatismyip.codes
- API Base URL: https://whatismyip.technology/api
- Purpose: Free IP geolocation, WHOIS, blacklist check, port scan, SSL check, HTTP headers API
- Auth: None required for any endpoint
- Format: JSON only
- CORS: Open (Access-Control-Allow-Origin: *)
- Part of the WhatIsMyIP ecosystem (whatismyip.technology, whatismyip.wiki, whatismyip.codes)

## API Endpoints

### 1. IP Geolocation (Your IP)
- Endpoint: GET /api/me
- Docs: https://whatismyip.codes/docs/ip-geolocation/
- No parameters. Auto-detects requester's IP.
- Returns: ip, country, countryCode, region, city, zip, lat, lon, timezone, isp, org, as, asName, rdns, mobile, proxy, hosting

### 2. IP Lookup (Any IP)
- Endpoint: GET /api/ip-lookup?ip={address}
- Docs: https://whatismyip.codes/docs/ip-lookup/
- Parameter: ip (required, IPv4 or IPv6)
- Returns: same geolocation fields as /api/me but for any specified IP

### 3. WHOIS / RDAP
- Endpoint: GET /api/whois?q={domain_or_ip}
- Docs: https://whatismyip.codes/docs/whois/
- Parameter: q (required, domain name or IP address)
- Returns: Domain registration data (registrar, dates, nameservers) or IP network info (CIDR, org, abuse contact)

### 4. Blacklist Check
- Endpoint: GET /api/blacklist?ip={address}
- Docs: https://whatismyip.codes/docs/blacklist/
- Parameter: ip (required, IPv4 only)
- Returns: results from 15 DNSBLs with listed/not-listed status per list

### 5. Port Scan
- Endpoint: GET /api/port-scan?host={host}&port={port}
- Docs: https://whatismyip.codes/docs/port-scan/
- Parameters: host (required), port (required, 1-65535)
- Returns: whether the TCP port is open. Blocks private/internal ranges.

### 6. SSL Certificate Check
- Endpoint: GET /api/ssl-check?host={domain}
- Docs: https://whatismyip.codes/docs/ssl-check/
- Parameter: host (required, domain name)
- Returns: issuer, commonName, validFrom, validTo, daysLeft, expired, expiringSoon, SANs

### 7. HTTP Headers
- Endpoint: GET /api/http-headers
- Docs: https://whatismyip.codes/docs/http-headers/
- No parameters. Returns all HTTP headers the client sent with the request.

## Code Examples
- [curl](https://whatismyip.codes/examples/curl/): Command line examples for all endpoints
- [Python](https://whatismyip.codes/examples/python/): requests and aiohttp examples
- [JavaScript](https://whatismyip.codes/examples/javascript/): Browser fetch, Node.js, TypeScript types
- [Go](https://whatismyip.codes/examples/go/): net/http with struct definitions
- [PHP](https://whatismyip.codes/examples/php/): file_get_contents and cURL
- [Ruby](https://whatismyip.codes/examples/ruby/): Net::HTTP examples

## Documentation
- [Getting Started](https://whatismyip.codes/docs/): Overview of all endpoints and base URL
- [IP Geolocation](https://whatismyip.codes/docs/ip-geolocation/): GET /api/me
- [IP Lookup](https://whatismyip.codes/docs/ip-lookup/): GET /api/ip-lookup
- [WHOIS](https://whatismyip.codes/docs/whois/): GET /api/whois
- [Blacklist](https://whatismyip.codes/docs/blacklist/): GET /api/blacklist
- [Port Scan](https://whatismyip.codes/docs/port-scan/): GET /api/port-scan
- [SSL Check](https://whatismyip.codes/docs/ssl-check/): GET /api/ssl-check
- [HTTP Headers](https://whatismyip.codes/docs/http-headers/): GET /api/http-headers
- [Rate Limits](https://whatismyip.codes/docs/rate-limits/): Usage guidelines
- [Errors](https://whatismyip.codes/docs/errors/): Error codes and handling
- [Changelog](https://whatismyip.codes/docs/changelog/): API change history

## Key Facts
- Completely free, no paid tiers
- No API key or authentication needed
- Commercial use allowed
- No data logged or stored
- HTTPS only
- All responses are JSON with consistent field names
- Built by Outline Technologies (https://outline.ad)

## Ecosystem
- [whatismyip.technology](https://whatismyip.technology): 15 free IP and networking tools
- [whatismyip.wiki](https://whatismyip.wiki): Networking knowledge base with 48 articles
- [whatismyip.codes](https://whatismyip.codes): This API documentation site

## All Page URLs
https://whatismyip.codes/
https://whatismyip.codes/docs/
https://whatismyip.codes/docs/ip-geolocation/
https://whatismyip.codes/docs/ip-lookup/
https://whatismyip.codes/docs/whois/
https://whatismyip.codes/docs/blacklist/
https://whatismyip.codes/docs/port-scan/
https://whatismyip.codes/docs/ssl-check/
https://whatismyip.codes/docs/http-headers/
https://whatismyip.codes/docs/rate-limits/
https://whatismyip.codes/docs/errors/
https://whatismyip.codes/docs/changelog/
https://whatismyip.codes/examples/
https://whatismyip.codes/examples/curl/
https://whatismyip.codes/examples/python/
https://whatismyip.codes/examples/javascript/
https://whatismyip.codes/examples/go/
https://whatismyip.codes/examples/php/
https://whatismyip.codes/examples/ruby/
https://whatismyip.codes/about/
https://whatismyip.codes/privacy/
https://whatismyip.codes/tos/