Retrieve resort accommodations

  • Accommodations
  • Resort content
  • 1 route
How do I browse a resort accommodation catalogue?

This scenario shows how to retrieve the accommodation catalogue attached to one resort product in order to expose rooms or lodging choices in a product information journey.

Overview

Use GET/v1/products/{product_id}/accommodations to retrieve the resort accommodation list for a given product. This route is useful when a front-end must display the lodging offer before a shopping or booking action.

Prerequisites

  • product_id must be known.
  • accept-language and x-api-key are required on the documented call.
  • Additional query parameters are not fully visible in the available source material.
1

List the resort accommodations

Mandatory

Use GET/v2/products/{product_id}/accommodations to browse the accommodation catalog of a resort and inspect room types, capacities, and labels.

Prerequisites

Prepare product_id. Keep x-api-key and, when the route is customer-scoped, a valid bearer token.

Calling CURL

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: en-US" \
  "https://api.clubmed.com/v2/products/{product_id}/accommodations"

Example answer

[
  {
    "id": "room-1",
    "label": "Superior Room",
    "occupancy": 2,
    "availability": "AVAILABLE"
  }
]

info: Reuse accommodation ids or room labels from this catalog if the journey later drills into one room type.

Response codes

  • 200 OK: the expected data is returned.
  • 400 Bad Request: the request is invalid or incomplete.
  • 404 Not Found: the requested resource cannot be found.
GET/v2/products/{product_id}/accommodations
See more