API Documentation

Access our IP geolocation lookup API with JWT authentication

Authentication

API Domain: api.ip-query.com

Authentication Method: JWT JWT Token

API Key Allocation: Using GitHub OAuth2 login to obtain

Revoke Token

Revoke an API token to disable its access.

curl -X DELETE https://api.ip-query.com/api/revoke-token \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "X-Revoke-Token: TOKEN_TO_REVOKE"

API Endpoints

GET /api/lookup/:ip

Get geolocation information for a given IP address

Parameters:
  • ip (Required) - IP address to query (supports both IPv4 and IPv6)
  • Authorization (Required) - JWT token obtained via GitHub OAuth2
Usage Example:
curl -X GET https://api.ip-query.com/api/lookup/8.8.8.8 \ -H "Authorization: Bearer YOUR_JWT_TOKEN"
Response Example:
{ "ip": "8.8.8.8", "country": "United States", "country_code": "US", "region": "California", "city": "Mountain View", "isp": "Google LLC", "latitude": 37.4056, "longitude": -122.0775, "timezone": "America/Los_Angeles", "zip": "94043" }

GET /api/status

Get API service status and health check

Parameters:
  • Authorization (Required) - JWT token obtained via GitHub OAuth2
Usage Example:
curl -X GET https://api.ip-query.com/api/status \ -H "Authorization: Bearer YOUR_JWT_TOKEN"

GET /api/myip

Get geolocation information for your own IP address

Parameters:
  • Authorization (Required) - JWT token obtained via GitHub OAuth2
Usage Example:
curl -X GET https://api.ip-query.com/api/myip \ -H "Authorization: Bearer YOUR_JWT_TOKEN"

Rate Limits