Development Environment

Our Development Environment offers a seamless integration process for our API with your website or application. To ensure that your current plan’s available requests remain unaffected, we recommend implementing the integration by adding the mode=test parameter to your request. We highly recommend testing your integration thoroughly with mode=test before removing it from your requests to ensure that everything is functioning as expected.

This parameter accepts two values, which are test and live and will be working for all our modules.

Please note that after setting this option to test you will get fake information, it’s used just through the development stage.

Once the integration process is complete, you can remove the mode=test parameter from your API requests. This parameter is designed solely for testing purposes and has no impact on the actual functionality of the API.

Sample requests (API v2)

IP geolocation for the caller (no IP in the path):

cURL

curl -G 'https://v2.greipapi.com/geo/ip' \
  --data-urlencode 'params=location,currency' \
  --data-urlencode 'mode=test' \
  -H 'Authorization: Bearer <api-key>'

Lookup for a specific IP:

cURL

curl -G 'https://v2.greipapi.com/lookup/ip/1.1.1.1' \
  --data-urlencode 'params=location,currency' \
  --data-urlencode 'mode=test' \
  -H 'Authorization: Bearer <api-key>'

Include your API key on every request:

Authorization: Bearer <api_key>

API v2 does not accept key in the query string or JSON body. See Authentication.

Get Started

API Features

Sample requests (API v2)

​Sample requests (API v2)

Sample requests (API v2)