Authentication

The Ipregistry API uses API keys to authenticate requests. You can pass your API key in the URL:

https://api.ipregistry.co?key=YOUR_API_KEY

or as an Authorization header if you prefer to hide the key from the URL:

Authorization: ApiKey YOUR_API_KEY

Here are command-line examples using cURL:

$ curl https://api.ipregistry.co?key=YOUR_API_KEY
$ curl -H "Authorization: ApiKey YOUR_API_KEY" https://api.ipregistry.co

If you do not include a key or use one that is incorrect, Ipregistry returns a specific error.

Managing API keys

You can view and manage your API keys in the Ipregistry Dashboard.

Ipregistry allows creating multiple API keys per account to separate concerns but also restricting usage per IP addresses, origins or throttle/rate limit invocations per hour.