IP Lookup API Documentation

# Use this endpoint to make a requests to the API
# GET Request
https://api.apiverve.com/v1/iplookup
                 

IP Lookup is a simple tool for looking up the location of an IP address. It returns the country, city, and more.

To use this API, you need an API key. You can get one by creating an account on apiverve.com and visiting your dashboard.

Important: Ensure that this API is enabled from within your dashboard to use it in your application. If not, you may receive a 403 error

Most of our APIs are also available on and

Example Response :

{
  "status": "ok",
  "error": null,
  "data": {
    "range": [
      2913751040,
      2913753087
    ],
    "country": "US",
    "region": "MO",
    "timezone": "America/Chicago",
    "city": "Kansas City",
    "coordinates": [
      39.0537,
      -94.5906
    ],
    "ip": "173.172.81.20"
  }
}
                

Lookup the details and location of an IP address

QUERY PARAMETERS

SAMPLE REQUEST QUERY

# PERFORM A GET REQUEST
https://api.apiverve.com/v1/iplookup?ip=173.172.81.20
                

RESPONSE CONTENT TYPES

The IP Lookup API supports the following response content types:

application/json, application/xml, application/yaml

You can specify the response content type by setting the Accept header in your request. If you don't specify a content type, the API will default to application/json.

Authentication

# Here is a curl example
curl \
-X GET https://api.apiverve.com/v1/iplookup \
-H 'x-api-key={{YOUR-API-KEY}}' \
-F 'auth=true' \
                

The IP Lookup API uses an API Key to authenticate requests. You can view and manage your API key by visiting your dashboard.

Your API keys carry many privileges. To keep them from being abused, please do not share the keys on client-side code or Github etc. Keep them very secure.

To use any API, you must have it enabled from within your dashboard. Disabled APIs will fail to respond to your requests.

All requests made to the API must contain the header x-api-key in each of your requests. API requests without authentication will fail.

All API requests must also be made over secure HTTPS. Requests made over plain HTTP will fail.

Rate Limits

{
    "status": "error",
    "data": null,
    "error": "Rate limit exceeded. Please upgrade your subscription plan."
}
                

Each subscription has its own rate limit. Your limit is based on your subscription plan (free or paid). If you exceed your limits, don't worry. You can always upgrade or downgrade at any time.

When you reach your limit, the service will stop responding and typically return an HTTP 429 response status code. The error will also contain a details JSON.

The IP Lookup API uses the following error code:

Errors

For reference, the IP Lookup API uses the following error codes: