Rooms and rates

These five reads describe what the hotel sells and on what terms. They change rarely: cache them and refresh every few hours, or when an offer mentions an ID you do not know. Prices for actual dates come from offer search, not from here.

All five take the property in the path. A property_id other than the credential's own answers 404 Property not found.

List room typesCopy Anchor Link

Returns every room type of the property, active or not, in the hotel's own order, with its occupancy, base price, amenities, photos and how many active rooms it has.

ParametersCopy Anchor Link

ExampleCopy Anchor Link

curl -X GET "https://api.chatbeds.app/partner/v1/properties/19306340-c7cf-465a-93d3-0b7873a7e85d/room-types" \
  -H "Authorization: Bearer cbk_••••"

{
  "room_types": [
    {
      "id": "da3b4c87-c1ca-4f13-8c90-066900f16d48",
      "name": "Standard",
      "description": null,
      "base_price": 90.0,
      "currency": "USD",
      "max_occupancy": 2,
      "max_adults": null,
      "max_children": null,
      "bed_type": null,
      "size_sqm": null,
      "amenities": [],
      "photos": [],
      "units": 6,
      "active": true
    },
    {
      "id": "cd4932a5-a172-4147-bfd6-fcd79a42af11",
      "name": "Deluxe",
      "description": null,
      "base_price": 140.0,
      "currency": "USD",
      "max_occupancy": 3,
      "max_adults": null,
      "max_children": null,
      "bed_type": null,
      "size_sqm": null,
      "amenities": [],
      "photos": [],
      "units": 4,
      "active": true
    }
    // ... one more (Suite)
  ]
}

ErrorsCopy Anchor Link

List rate plansCopy Anchor Link

Returns the hotel's rate plans: named ways of selling a room (with breakfast, non-refundable, long stay), each with its stay rules and cancellation policy. A plan with room_type_id set applies only to that room type; null means any. The sandbox has none, so the list is empty until you add one in the sandbox hotel.

ParametersCopy Anchor Link

ExampleCopy Anchor Link

curl -X GET "https://api.chatbeds.app/partner/v1/properties/19306340-c7cf-465a-93d3-0b7873a7e85d/rate-plans" \
  -H "Authorization: Bearer cbk_••••"

{
  "rate_plans": []
}

Each item has these fields:

ErrorsCopy Anchor Link

List unitsCopy Anchor Link

Returns the physical rooms ("units"), sorted by name, with their room type and housekeeping status. You need them only to book a specific room (unit_id) or to show room numbers.

ParametersCopy Anchor Link

ExampleCopy Anchor Link

curl -X GET "https://api.chatbeds.app/partner/v1/properties/19306340-c7cf-465a-93d3-0b7873a7e85d/units" \
  -H "Authorization: Bearer cbk_••••"

{
  "units": [
    {
      "id": "00635381-d0c0-4383-9bc0-7c74bfac07ec",
      "name": "101",
      "room_type_id": "da3b4c87-c1ca-4f13-8c90-066900f16d48",
      "floor": null,
      "status": "OCCUPIED",
      "active": true
    },
    {
      "id": "b1104463-171d-4f9e-8a65-a915207b1cba",
      "name": "103",
      "room_type_id": "da3b4c87-c1ca-4f13-8c90-066900f16d48",
      "floor": null,
      "status": "CLEAN",
      "active": true
    }
    // ... 10 more
  ]
}

status is the housekeeping state today: CLEAN, DIRTY, CLEANING, INSPECTING, READY, OCCUPIED, MAINTENANCE or DND. It says nothing about whether the room is free on future dates; use offers for that.

ErrorsCopy Anchor Link

List extrasCopy Anchor Link

Returns the extras on sale (breakfast, airport pick-up, late check-out) with their price and how they are charged. Add them when booking (extras) or later with reservation.addExtra. Only active extras are listed. The sandbox has none, so the list is empty until you add one in the sandbox hotel.

ParametersCopy Anchor Link

ExampleCopy Anchor Link

curl -X GET "https://api.chatbeds.app/partner/v1/properties/19306340-c7cf-465a-93d3-0b7873a7e85d/extras" \
  -H "Authorization: Bearer cbk_••••"

{
  "extras": []
}

Each item has these fields:

The amount charged is price times the quantity, times the nights for a per-night extra, times the guests (adults plus children) for a per-person extra.

ErrorsCopy Anchor Link

Get policiesCopy Anchor Link

Returns the hotel's terms: check-in and check-out times, tax, fees charged on every stay, and its cancellation policies. Show the cancellation terms to the guest before they book: when you cancel, the hotel's policy applies and you cannot waive its fee.

ParametersCopy Anchor Link

ExampleCopy Anchor Link

curl -X GET "https://api.chatbeds.app/partner/v1/properties/19306340-c7cf-465a-93d3-0b7873a7e85d/policies" \
  -H "Authorization: Bearer cbk_••••"

{
  "check_in_time": "14:00",
  "check_out_time": "12:00",
  "currency": "USD",
  "tax": {
    "rate": 0.0,
    "included_in_prices": false
  },
  "fees": [],
  "cancellation_policies": [],
  "default_cancellation_policy_id": null
}

Which policy applies to a booking: the rate plan's own policy if it has one, otherwise the hotel's default. A non-refundable plan with no policy of its own charges the room price whenever it is cancelled.

ErrorsCopy Anchor Link