Authentication

You'll need to authenticate your requests to access any of the endpoints in the Polaris API. In this guide, we'll look at how authentication works.

Access Tokens

The recommended way to authenticate with the Polaris API is by access tokens. You will need your access token — you will find it in the Polaris dashboard under Accounts. Here's how to add the token to the request header using cURL:

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

Example request with bearer token

curl https://api.polaris.revlv.com/v1/service_lines \
  -H "Authorization: Bearer {token}"
  -H "Polaris-Account: {account_number}"

By default access tokens doesn't expire, unless you specify an expiration.

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 Polaris dashboard under API settings, and the client library will take care of the rest. All the client libraries use access tokens behind the scenes.

Was this page helpful?