HRN V2 API

V2 is the current API surface for the Hurtigruten Norway B2B integration. It covers read-only inventory (voyages, packages, promotions, reference data) and the full booking flow (search, hold, modify, confirm).

For an end-to-end walkthrough, start with Booking flow. The remaining concept pages cover session lifecycle, identifier stability, the error model, locale and market, and operational notes.

Issues and feedback go through the B2B Support Portal.

Environments

Environment	Base URL
Staging	https://partner.staging.hurtigruten.com/api/v2
Production	https://partner.hurtigruten.com/api/v2

Staging behaves identically to production; switch base URL to promote.

Authentication

Each integration is provisioned a clientId and clientSecret. Use them to obtain a bearer token from Auth0:

Environment	Token URL	Audience
Staging	https://b2b-portal-staging.eu.auth0.com/oauth/token	https://staging.partner.hurtigruten.com/api
Production	https://b2b-portal-production.eu.auth0.com/oauth/token	https://partner.hurtigruten.com/api

curl --request POST \
  --url https://b2b-portal-staging.eu.auth0.com/oauth/token \
  --header 'content-type: application/json' \
  --data '{
    "client_id":"YOUR_CLIENT_ID",
    "client_secret":"YOUR_CLIENT_SECRET",
    "audience":"https://staging.partner.hurtigruten.com/api",
    "grant_type":"client_credentials"
  }'

{
  "access_token": "eyJhbGciOiJI...",
  "scope": "application:Partner.WebApi",
  "expires_in": 86400,
  "token_type": "Bearer"
}

Cache the token until expires_in; do not re-authenticate on every call. See operational notes for token-handling guidance.

user_key

In addition to the bearer token, every endpoint requires a user_key query parameter — your agency's unique key. The same user_key issued for V1 also works for V2.

curl --location 'https://partner.staging.hurtigruten.com/api/v2/voyages?user_key=ab48d6s2db8s63f2e1b987' \
  --header 'Authorization: Bearer YOUR_BEARER_TOKEN'

Rate limiting

There is no rate limiting today; this is subject to change. See operational notes.