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

Authorization is the header name and ApiKey YOUR_API_KEY the header value.

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 from the Ipregistry Dashboard.

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