Welcome to the iii.vg API documentation. This document provides details for various public APIs offered, primarily focusing on GeoIP lookup services.
Please review the "General Notes" for important information applicable to all APIs listed here, followed by details for specific endpoints.
General Notes
Authentication: All APIs listed here currently do not require authentication.
HTTPS Required: All API requests must be made over HTTPS. Requests made over plain HTTP will likely fail or be redirected.
Data Freshness: The GeoIP APIs (MaxMind, IP2Location) use the latest available data by default and are automatically updated when new database versions are released by their respective providers.
Rate Limiting: APIs may be subject to rate limiting to ensure fair usage and stability. See the "Rate Limiting" section for more details.
Rate Limiting
To ensure fair usage and stability of our services, API requests may be rate-limited. The specific limits can vary per API and are subject to change.
If you exceed the rate limit, you will likely receive an HTTP 429 Too Many Requests response. Response headers may include:
X-RateLimit-Limit: The total number of requests allowed in the current window.
X-RateLimit-Remaining: The number of requests remaining in the current window.
Retry-After or X-RateLimit-Reset: Information on when you can retry.
Please implement proper error handling in your application to manage rate limits gracefully.
Error Codes
Standard HTTP status codes are used. Common ones include:
Status Code
Meaning
200 OK
Request successful.
400 Bad Request
Invalid request parameters or format.
404 Not Found
Requested resource or API path not found.
429 Too Many Requests
Rate limit exceeded.
500 Internal Server Error
Server-side error.
Error responses are typically in JSON format and include an "error" field with a descriptive message.
API Endpoints
GETmaxmind.ip.api.iii.vg/
Provides GeoIP information for an IP address using MaxMind GeoLite2 databases. This service is automatically updated when new database drops occur.
Latest Database Set Details
The "Latest" option refers to the most current data (e.g., 2025-05-30 or newer).