Step 1: Create an account

To make your first API request you’ll first need to create a Developer Portal account.
Once your email address is verified, you’re ready to start developing your first application.

Step 2: Register your first application

Now you have successfully registered, you are ready to create a key and test our APIs.

  1. Go to My API Keys and click on Add A New Key
  2. Give your new Key a name (e.g. ‘My Test Key’)
  3. Select the product that will be associated with this key( e.g. ‘IPAddressValidation’)
  4. Click Create Key and start exploring.

Step 3: Get an access token

When you create a key you are given a Client ID and Client Secret.

Get your access token by following the steps in our OAuth2 tutorial

curl -X POST \
  -H 'Content-Type: application/json' \
  -d '{ "client_id": "<CLIENT_ID>","client_secret": "<CLIENT_SECRET>" , "grant_type" : "client_credentials" }'

Response Example:

  "issued_at" : "1525190727056",
  "expires_in" : "3599",
  "token_type" : "BearerToken",
  "access_token" : "kE8WyfAAgaoPPisGakxRw9aEL8eH",
  "status" : "approved"

Step 4: Send your first API request

Use your access token as a bearer token in the authorization header and make your first API call

curl -X GET \
	-H 'Content-Type: application/json' \
	-H 'Accept: application/json' \
	-H 'Authorization: Bearer <ACCESS_TOKEN>' \
	-d '{ "IP" : "" }'