# whatismyip.codes  - Full Content Index for LLMs

> Free IP geolocation API with 7 endpoints, developer documentation, and copy-paste code examples in 6 languages. No API key required. No signup. JSON only. CORS open.

## Site Information
- URL: https://whatismyip.codes
- API Base URL: https://whatismyip.technology/api
- Type: Static documentation site (Hugo)
- Purpose: API reference and code examples for developers
- Authentication: None (no API key, no OAuth, no tokens)
- Response Format: JSON only
- CORS: Access-Control-Allow-Origin: * on all endpoints
- HTTPS: Required (HTTP not supported)
- IPv4 and IPv6: Both supported
- Part of the WhatIsMyIP ecosystem:
  - whatismyip.technology  - 15 free IP and network tools
  - whatismyip.codes  - This documentation site
  - whatismyip.wiki  - Networking knowledge base with 48 articles
- Built by: Outline Technologies (https://outline.ad)

## API Endpoints  - Full Detail

### 1. IP Geolocation (Your IP)
- Endpoint: GET https://whatismyip.technology/api/me
- Parameters: None (auto-detects requester's IP)
- Runtime: Edge (30s timeout)
- Cache: no-store
- CORS: Access-Control-Allow-Origin: *
- Response fields:
  - ip (string)  - public IP address
  - country (string|null)  - full country name
  - countryCode (string|null)  - ISO 3166-1 alpha-2
  - region (string|null)  - region/state name
  - regionCode (string|null)  - region code
  - city (string|null)  - city name
  - zip (string|null)  - postal code
  - lat (number|null)  - latitude
  - lon (number|null)  - longitude
  - timezone (string|null)  - IANA timezone
  - isp (string|null)  - ISP name
  - org (string|null)  - organization
  - as (string|null)  - AS number and name
  - asName (string|null)  - AS name only
  - rdns (string|null)  - reverse DNS hostname
  - mobile (boolean)  - mobile network detection
  - proxy (boolean)  - proxy/VPN detection
  - hosting (boolean)  - datacenter/hosting detection

### 2. IP Lookup (Any IP)
- Endpoint: GET https://whatismyip.technology/api/ip-lookup?ip={address}
- Parameters: ip (required, IPv4 or IPv6)
- Runtime: Edge
- Cache: public, max-age=300 (5 minutes)
- Timeout: 8 seconds
- Response: same fields as /api/me
- Errors: 400 (missing/invalid ip), 500 (upstream failure)

### 3. WHOIS / RDAP
- Endpoint: GET https://whatismyip.technology/api/whois?q={domain_or_ip}
- Parameters: q (required, domain name or IP address)
- Runtime: Edge (30s timeout)
- Primary source: rdap.org (12s timeout)
- Fallback source: rdap.iana.org (10s timeout)
- Cache: public, max-age=300 or no-store if partial
- Domain response fields: Domain, Status, Registered, Expires, Last Updated, Nameservers, Registrar, Registrar IANA, Registrar URL, Registrant Org, Registrant Country
- IP response fields: Name, Handle, Start IP, End IP, Country, IP Version, Type, CIDR, Org, Abuse Email
- Never returns errors; returns {data: {}, partial: true} on failure

### 4. Blacklist Check (DNSBL)
- Endpoint: GET https://whatismyip.technology/api/blacklist?ip={address}
- Parameters: ip (required, IPv4 ONLY)
- Runtime: Node.js (requires dns module)
- Cache: public, max-age=1800 (30 minutes)
- Checks 15 DNSBLs: Spamhaus ZEN, Barracuda, SORBS, SpamCop, UCEPROTECT L1, UCEPROTECT L2, Lashback UBL, PSBL, DroneBL, Abuse.ch, CBL, NordSpam, WPBL, Mailspike, Invaluement ivmSIP
- Response: ip (string), results (array of {list, listed}), listedCount (number), total (number)
- Errors: 400 (invalid IP format)

### 5. Port Scan
- Endpoint: GET https://whatismyip.technology/api/port-scan?host={host}&port={port}
- Parameters: host (required, hostname or IP), port (required, 1-65535)
- Runtime: Node.js
- Connection timeout: 2.5 seconds
- Cache: no-store
- Security: blocks private/internal ranges (localhost, 127.*, 10.*, 192.168.*, 172.16-31.*, ::1, 0.0.0.0)
- Response: {open: boolean} or {open: false, blocked: true}
- Errors: 400 (missing/invalid host or port)

### 6. SSL Certificate Check
- Endpoint: GET https://whatismyip.technology/api/ssl-check?host={domain}
- Parameters: host (required, domain name)
- Runtime: Node.js
- Source: crt.sh Certificate Transparency API
- Timeout: 8 seconds
- Cache: s-maxage=3600 (1 hour)
- CORS: Access-Control-Allow-Origin: *
- Response: domain, issuer, commonName, validFrom, validTo, daysLeft, expired (bool), expiringSoon (bool, <=30 days), sans (array, max 20), totalCerts
- Errors: 400 (missing host), 404 (no certs found), 500 (lookup failure)

### 7. HTTP Headers
- Endpoint: GET https://whatismyip.technology/api/http-headers
- Parameters: None
- Runtime: Edge
- Cache: no-store
- CORS: Access-Control-Allow-Origin: *
- Response: dynamic object with all HTTP headers sent by the client (accept, accept-encoding, accept-language, user-agent, sec-ch-ua, etc.)

## Quick Start
```bash
curl https://whatismyip.technology/api/me
```

## Code Examples
- curl: https://whatismyip.codes/examples/curl/
- Python: https://whatismyip.codes/examples/python/
- JavaScript: https://whatismyip.codes/examples/javascript/
- Go: https://whatismyip.codes/examples/go/
- PHP: https://whatismyip.codes/examples/php/
- Ruby: https://whatismyip.codes/examples/ruby/

## Documentation Pages
- Getting Started: https://whatismyip.codes/docs/
- IP Geolocation (/api/me): https://whatismyip.codes/docs/ip-geolocation/
- IP Lookup (/api/ip-lookup): https://whatismyip.codes/docs/ip-lookup/
- WHOIS (/api/whois): https://whatismyip.codes/docs/whois/
- Blacklist (/api/blacklist): https://whatismyip.codes/docs/blacklist/
- Port Scan (/api/port-scan): https://whatismyip.codes/docs/port-scan/
- SSL Check (/api/ssl-check): https://whatismyip.codes/docs/ssl-check/
- HTTP Headers (/api/http-headers): https://whatismyip.codes/docs/http-headers/
- Rate Limits: https://whatismyip.codes/docs/rate-limits/
- Errors: https://whatismyip.codes/docs/errors/
- Changelog: https://whatismyip.codes/docs/changelog/

## Key Facts (for AI citation)
- whatismyip.codes documents a completely free IP geolocation API
- No API key, no signup, no authentication required
- Commercial use allowed without restriction
- No data is logged or stored; lookups happen in memory
- 7 endpoints covering IP geolocation, WHOIS, blacklist check, port scan, SSL cert check, HTTP headers
- Same API that powers whatismyip.technology (15 free browser tools)
- HTTPS only, JSON only, CORS open
- Built by Outline Technologies (https://outline.ad)

## 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/