Getting started
Base URLs & markets
The hostname selects the market, its currency, and the storefront used in product links. Paths are relative to /api/v1.
Confirm your base URL with Cru
These are the production hosts. A credential can be restricted to particular markets, and your account may be issued against a different environment — confirm the base URL with Cru before deploying an integration.
| MARKET | CURRENCY | PRODUCTION BASE URL |
|---|---|---|
| United Kingdom uk_en | GBP | https://uk.cruworldwine.com/api/v1 |
| United States us_en | USD | https://us.cruworldwine.com/api/v1 |
| Hong Kong hk_en | HKD | https://hk.cruworldwine.com/api/v1 |
| Singapore sg_en | SGD | https://sg.cruworldwine.com/api/v1 |
| Europe eu_en | EUR | https://eu.cruworldwine.com/api/v1 |
| United Arab Emirates ae_en | AED | https://ae.cruworldwine.com/api/v1 |
| China cn_en | CNY | https://cn.cruworldwine.com/api/v1 |
Market restrictions
A credential can be restricted to particular markets. An unpermitted hostname returns A009 / 403, including for /ping. Compare store with allowed_stores in the error and select a permitted base URL.
Currency
All bid prices within a market use its currency. The API does not silently convert a quote into another currency.