Introduction

Installation

Configure your API integration by selecting the appropriate base URL and generating authentication credentials. This setup is required before making any API requests.


Base URLs

RegionBase URL
Canadahttps://api.hlc.bike/ca/v3.0
USAhttps://api.hlc.bike/us/v3.0

Use case: A multi‑region dealer routes traffic based on account location.


Generate an access token

Log in to hlc.bike, open My Account → User Settings, expand your user row, then use the External Services tab to generate an Access Token.

If you don’t see the External Services tab, contact support:

  • USA: customerexperience@hlc.bike
  • Canada: info@hlc.bike

First authenticated request

const baseUrl = 'https://api.hlc.bike/us/v3.0'
const apiKey = process.env.HLC_API_KEY

const res = await fetch(
  `${baseUrl}/Catalog/Products?pageStartIndex=1&pageSize=50`,
  {
    headers: {
      ApiKey: apiKey,
      language: 'en',
      callerName: 'install-check',
    },
  },
)

const products = await res.json()

Security tip

Store tokens in a secrets manager. Never ship them to the browser.

Previous
Getting started