GET
/
v1
/
itineraries
/
{itineraryId}
/
accommodations
List accommodations (internal)
curl --request GET \
  --url https://api.hofj.com/v1/itineraries/{itineraryId}/accommodations \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "elements": [
      {
        "id": "<string>",
        "title": "<string>",
        "rating": 123,
        "guestRating": 123,
        "isRecommended": true,
        "totalPrice": {
          "amount": "<string>",
          "currency": "<string>"
        },
        "image": {
          "url": "<string>",
          "name": "<string>",
          "alternativeText": "<string>",
          "caption": "<string>",
          "width": 123,
          "height": 123
        },
        "startDate": "2023-11-07T05:31:56Z",
        "nights": 123,
        "address": "<string>",
        "roomsConfiguration": [
          {
            "price": {
              "amount": "<string>",
              "currency": "<string>"
            },
            "isActive": true,
            "rooms": [
              {
                "id": "<string>",
                "name": "<string>",
                "numPax": 123,
                "description": "<string>",
                "count": 123,
                "numPaxValues": [
                  123
                ]
              }
            ]
          }
        ],
        "source": "<string>",
        "description": "<string>",
        "gallery": [
          {
            "url": "<string>",
            "name": "<string>",
            "alternativeText": "<string>",
            "caption": "<string>",
            "width": 123,
            "height": 123
          }
        ],
        "endDate": "2023-11-07T05:31:56Z",
        "coordinates": {
          "latitude": 123,
          "longitude": 123
        },
        "reviewsCount": 123
      }
    ],
    "pagination": {},
    "aggregate": {
      "sorting": [
        "<string>"
      ],
      "filters": [
        {
          "id": "guestRating",
          "type": "slide",
          "values": [
            "<string>"
          ]
        }
      ]
    }
  },
  "meta": {
    "now": 123
  }
}

Authorizations

Authorization
string
header
default:dev-internal-api-key
required

Use Authorization: Bearer <access_token> from POST /v1/oauth/token, or Authorization: Bearer <api_key>. Dev-only example key (do not use in production): see repository README.

Path Parameters

itineraryId
string
required

Identifier of the itinerary (cart) returned by POST /v1/itineraries.

Query Parameters

brand
string

Distribution channel brand: matches channel name or domainUrl (e.g. Weebora, weebora.com, booking.hofj.com, terrarossa.com). The resolved domain is BOTH the upstream host AND the tenant routing value. If omitted, CONTENT_DEFAULT_CHANNEL_DOMAIN must be set server-side.

locale
enum<string>

Locale for the brand site (it, en, es, fr). Injected as /{locale}/api/... on the upstream call. Defaults to CONTENT_DEFAULT_LOCALE.

Available options:
it,
en,
es,
fr
startDate
string<date>
required

Trip start date.

page
integer
default:1
Required range: x >= 1
sortByValue
enum<string>
default:recommended
Available options:
recommended,
priceAsc,
priceDesc,
distance
stars
string

Comma-separated star ratings (e.g. 3,4,5).

rating
string

Comma-separated guest rating buckets (excellent,very-good,good,...).

price
string

Comma-separated price buckets (upstream-defined ranges).

distance
string

Comma-separated distance buckets.

Response

Accommodations page

data
object
required
meta
object