Skip to main content
GET
Bulk IP lookup

Authentication

Include your API key in the Authorization header:
API v2 accepts the key only in this header, not in query parameters or request bodies. See Authentication.

Query parameters

string
required
The ips command is used to specify the IP addresses you want to look up.Expected values: comma separated IP addresses (IPv4 or IPv6)Sample value: 1.1.1.1,2.2.2.2
string
The params command can be used to specify the required modules you want to get in the response.Expected values: security, currency, timezone, location, and/or deviceSample value: security,timezone,currencyFor more information please refer to Customize response modules.
string
default:"EN"
The lang command is used to get a response in a specific language.Expected values: EN, AR, DE, FR, ES, JA, ZH, or RUFor more information please refer to Localization.
string
The callback command can help you make the response a JSONP format.Expected values: any name that can be used as a function name in Javascript, e.g: myFunctionName.For more information please refer to JSONP callback.
string
default:"JSON"
The format command is used to get a response in a specific format.Expected values: JSON, XML, CSV, or NewlineFor more information please refer to Response format.
string
default:"live"
The mode command is used in the development stage to simulate the integration process before releasing it to the production environment.Expected values: live, or test.For more information please refer to Development environment.
string
Optional label for your own analytics or support correlation (for example a product or channel name).
string
The user_id command can be used to identify requests sent by specific users to monitor in the Events page.Expected values: email address, phone number, user id, name, etc.For more information please refer to User identifier.

Response properties

boolean
required
true when the request succeeded; false on error.
object
required
Map of IP address strings to lookup results. Each key is one address from the ips query (for example 1.1.1.1). Invalid or duplicate entries in ips are omitted.
integer
required
Time taken to process the request (milliseconds).

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

ips
string
required
params
string
lang
string
callback
string
format
string
default:JSON
mode
string
default:live
source
string
user_id
string

Response

200

OK