Skip to content
Topsort Documentation
API

Authenticating with Topsort APIs

Topsort’s APIs are authenticated via bearer tokens. Requests must include an authorization header containing an API key. If this header is missing or invalid, the HTTP response code will be 401 Unauthorized.

Terminal window
POST /v2/auctions HTTP/2
Host: sandbox.app.topsort.com
...
Authorization: Bearer <YOUR-API-KEY>
...

Obtaining an API Key

By this point we will have provided you with credentials for our Auction manager. Visit the Auction Manager: API Integration page to generate your API keys.

  1. Access the Topsort API Integration page by clicking on Settings, and then selecting API Integration.

  2. Generate an API key by pressing the Generate API key button.

    Note that there are two different types of keys: Marketplace API keys and Advanced API keys.

    In order to access the /auctions and /events endpoints, you must create a Marketplace API key. For all other APIs, you need an Advanced API key.

  3. Click on the Copy key button to the right of the newly generated token to copy it to your clipboard.

  4. Use the API Key on your servers.