whoami

About

whoami.upset.dev is a high-performance IP API service written in Go. It returns your IP address, geolocation, network, and browser information as JSON. CLI clients like curl, wget, and HTTPie receive ANSI-colored, column-aligned plain text output instead.

Use Cases

• —

  Self-hosted IP lookup. Run your own alternative to ipinfo.io or ip-api.com with no rate limits or third-party dependencies.

• —

  Network debugging. Verify what IP and headers a server sees when troubleshooting proxies, VPNs, or CDN configurations.

• —

  Frontend geolocation. Use the CORS-enabled JSON API directly from a browser to localize content or show region-specific UI.

• —

  CI/CD diagnostics. Check the egress IP of a runner or deployment environment from a pipeline script.

• —

  Privacy check. Confirm whether a VPN or proxy is working by comparing the returned IP and ASN against the expected exit node.

Features

• —

  IP geolocation — country, city, coordinates, timezone, and ASN via MaxMind GeoLite2.

• —

  Reverse DNS — resolves the PTR record for the client IP.

• —

  Reverse proxy support — reads CF-Connecting-IP, X-Forwarded-For, and X-Real-IP in priority order.

• —

  CORS enabled — accessible from any origin via browser fetch().

• —

  ANSI colored output — syntax-highlighted, column-aligned output for CLI clients.

• —

  UA sanitization — strips control characters, ANSI injection, and limits length.

• —

  Health check — available at /health.

API

Free, CORS-enabled, and requires no authentication.

curl https://whoami.upset.dev

const res = await fetch("https://whoami.upset.dev");
const { ip, country, city } = await res.json();