IPInfoDB

Overview

IPInfoDB resolves IP addresses to country, region, city, and timezone — a lightweight key-based IP lookup API.

Note (verified 2026-08): invalid keys return HTTP 200 with "statusCode": "ERROR" in the body (not a 4xx) — check the statusCode field, not the HTTP status.

Quick Start

IP lookup (replace YOUR_KEY):

curl "https://api.ipinfodb.com/v3/ip-city/?key=YOUR_KEY&ip=8.8.8.8&format=json"

{
  "statusCode": "OK",
  "statusMessage": "",
  "ipAddress": "8.8.8.8",
  "countryCode": "US",
  "countryName": "United States",
  "regionName": "California",
  "cityName": "Mountain View",
  "zipCode": "94035",
  "latitude": 37.386,
  "longitude": -122.0838,
  "timeZone": "-08:00"
}

Authentication

• Register at ipinfodb.com → free API key.
• Send it as the key query parameter.
• Invalid keys return 200 + "statusCode": "ERROR" (verified) — check the JSON.

Rate Limits & Notes

• Free tier: ~2 requests/second (check the site) — small; paid plans scale.
• format=json (or xml) selects the response format.
• Endpoints: /v3/ip-city/ (full lookup), /v3/ip-country/ (country only, cheaper).

FAQ

Is IPInfoDB free? Free tier with a low rate limit; more is paid.

Why 200 with statusCode ERROR? The API reports errors in the body (verified) — check statusCode.

What’s the difference between the endpoints? ip-city gives city-level data; ip-country only the country.