HX Partner API Documentation

Welcome to the HX Partner API documentation. This site provides comprehensive information on how to integrate with HX's services, including both expedition and Norwegian coastal voyages.

API

Flat files

Bulk product data delivered as files for keeping a local copy of inventory in sync. New integrations should start with V3 — see the Flat files overview to choose.

  • V3 — Voyages, ships, and ports served as plain JSON over simple GET endpoints
  • V1 — Bulk download of inventory data (sailings, ships, cabins, excursions, pricing) as a ZIP archive of JSON files

Getting Started

To start using the HX APIs, follow these steps:

  1. Contact us for credentials: Reach out to our support team via the support portal to get your API credentials.
  2. Authenticate with Auth0: Use your credentials to obtain a bearer token from Auth0.
  3. Make API Requests: Use the bearer token to authenticate your requests to the HX APIs.
Note

Agencies integrating through a tech partner should contact their tech partner to initiate the signup process on their behalf.

Authentication

Authentication may work differently depending on which API you're using. Please refer to the Getting Started page for each specific API for detailed instructions on how to authenticate.

All API requests require authentication via a bearer token from Auth0.

Note

API credentials are specific to either the HRN or HX APIs. Separate credentials are required to access each API.

Support

If you have any questions or need assistance, please contact our support team via the support portal.