API Key

The Surfe API uses API keys to authenticate requests and control access to the available features.

Managing the API Key

You can get your API key from the API Settings. API Keys are unique for each user, and each user can have only one at any given time.

Caution

The API Key is secret and it should be handled carefully. If you suspect your API Key has been compromised, delete it as soon as possible and create a new one in the Surfe dashboard.

Using the API Key in requests

All the requests sent to any Surfe API endpoint needs to be authenticated with a valid API Key. Include your API Key in the Authorization request header like so:

curl --location 'https://api.surfe.com/v1/*SOME ENDPOINT*/' \
--header 'Authorization: Bearer *YOUR API KEY*' \
--data ''

See the error responses section for details about unsuccesful authentication responses.

On this page