Getting Started

Get started with the HLC API by obtaining access credentials and making your first authenticated request.

Request API Access

To use the HLC API, you must first request access from your HLC sales representative:

• USA: [email protected]
• Canada: [email protected]

Once your account is approved for API access, you'll receive confirmation to proceed with token generation.

Generate an Access Token

After your account is enabled for API access, generate your access token through the HLC B2B web store:

1. Log into www.hlc.bike
2. Navigate to My Account → User Settings
3. Select the External Services tab
4. Click Generate Token

For complete token management instructions, see the Security guide.

API Base URLs

Select the appropriate base URL for your integration:

Make Your First Request

Test your API access by retrieving the brands catalog:

const apiUrl = 'https://api.hlc.bike/v4.1'
const apiKey = process.env.HLC_API_KEY

const response = await fetch(`${apiUrl}/Catalog/Brands`, {
  headers: {
    ApiKey: apiKey,
    language: 'en',
  },
})

if (!response.ok) {
  throw new Error(`HTTP ${response.status}: ${response.statusText}`)
}

const brands = await response.json()
console.log(`Found ${brands.length} brands`)
console.log(brands[0]) // Display first brand

Expected Response

[
  {
    "id": 1,
    "name": "SRAM"
  },
  {
    "id": 2,
    "name": "Shimano"
  }
  // ... additional brands
]