Your API requests are authenticated using the account's private API key. If you do not include your key when making an API request or use an incorrect one, we return an error. You can view your API keys in the dashboard under the developer's tab.

Authentication to the API is performed via HTTP Basic Auth. Provide your private API key as the basic auth username value. You do not need to provide a password.

Only HTTPs supported All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.


You can provide the private API key in a curl request as:

curl \
-u your_private_api_key:
# The colon prevents curl from asking for a password.

You can also use the "Authorization" header and provide base64 encoded value of the string your_private_api_key:

Notice the colon (:) after the private key. It is required otherwise, authentication will fail. The format is username:password. username is your private key and password is an empty string.

If you encode your_private_api_key: using base64, you will get eW91cl9wcml2YXRlX2FwaV9rZXk6

curl \
-H 'Authorization: Basic eW91cl9wcml2YXRlX2FwaV9rZXk6'