List Accommodation Candidates

Retrieve candidate accommodation items for a set.

Method

GET /v1/products/:id/accommodations/sets/:setId/items

Path Parameters

id · uuid · required

Product ID.

setId · uuid · required

Accommodation set ID.

Headers

Authorization · string

Bearer token (requires products:read).

Request Example

cURL

curl "https://api.voyantcloud.com/v1/products/prod_123/accommodations/sets/acset_01J0D0EY7XG9ZW5P0N5T0KX6QG/items" \
  -H "Authorization: Bearer $VOYANT_API_KEY"

Response Example

200 OK

{
  "items": [
    {
      "id": "acitem_01J0D0G0T5ZTRM87X7FQ0KCY4N",
      "set_id": "acset_01J0D0EY7XG9ZW5P0N5T0KX6QG",
      "property_product_id": "prod_property_123",
      "property_id": "prop_456",
      "room_type_id": "room_789",
      "rate_plan_id": "rate_101",
      "board": "half-board",
      "priority": 0,
      "pricing_source": "manual",
      "pricing_json": {}
    }
  ]
}

Items are sorted by priority (ascending). pricing_json stores structured overrides for manual pricing, while IDs reference linked lodging inventory.