One API, all versions

We've merged API v3.0 and v4.x into a single, forward-compatible experience. Both authentication models are supported, and all features are available to v3.0 users.

What’s unified

• v3.0 integrations keep working
• v4.0 and 4.1 features are now available to v3.0 integrations
• Security supports both classic access tokens and JWTs
• Legacy URLs are supported
  • Country in the URL or not—both formats work

Use case: Keep your existing v3.0 integration while adding new v4.x features without a full rewrite.

What changes for v3.0 users

You now have access to:

• Season order creation
• Price‑of‑cart preview before creating an order

Example: legacy URL still works

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

const res = await fetch(`${legacyUrl}/Catalog/Brands`, {
  headers: { ApiKey: apiKey },
})

const brands = await res.json()