You'll need to authenticate your requests to access any of the endpoints in the ipbase API. In this guide, we'll look at how authentication works. ipbase offers two ways to authenticate your API requests: API key as GET parameter, or via request header.

GET query parameter

You can pass your API key along with every request by adding it as a query parameter apikey

Example request with authentication via get request

curl ""

Please don't commit your ipbase password to GitHub!

HTTP Header

The recommended way to authenticate with the ipbase API through a HTTP request header:

Example request with authentication via header

curl "" \
  -H "apikey: YOUR-API-KEY"

Always keep your token safe and reset it if you suspect it has been compromised.

Using an SDK

If you use one of our official SDKs, you won't have to worry about any of the above — fetch your access token from the ipbase dashboard and the client library will take care of the rest. All the client libraries use OAuth2 behind the scenes.