Flat files

The Flat files API lets you pull HX's product catalogue as files and keep a local copy in sync, instead of calling the booking API for every lookup. Two generations are available:

• V3 — the current generation. Voyages, ships, and ports served as plain JSON over simple GET endpoints, scoped per market and regenerated daily. Request just the dataset you need, no archive to unpack.
• V1 — the original offering. A single downloadable ZIP archive containing the full inventory: sailings, ships, cabin grades, excursions, ports, pricing, and itineraries.

Which should I use?

Tip

For new integrations we recommend starting with V3 — it's the current generation and simpler to consume. V1 remains fully supported for existing integrations.

Both authenticate with the same Auth0 flow — see each guide for the specifics.