Unit configuration for vacation rentals

Coming December 2025: updates to the unit configuration schema for vacation rentals

For vacation rentals, the Content API returns an object named unit_configurations, which contains information about room and bed options for each property. Using this object lets you visually display the room and bed options.

We'll be implementing some updates to the API in the coming months, and as a result, some attributes the API currently uses will be deprecated.

Important note

This update applies to all vacation rentals using /properties/content, including those made through core APIs and through Vrbo supply. If you're using this vacation rental unit configuration to surface vacation rentals, you'll need to update. If you're not using this unit configuration, you don't need to take any action.

Please note: This change is a modification in data presentation. It does not constitute a breaking schema change.

Unit configuration updates

In the new version of the schema, the unit_configurations object now includes more detailed descriptions:

In multi-unit scenarios, you'll receive more precise unit information. For example, instead of the current object key 1 or Other1, the new approach prepends the room ID to the key for each unit, like so: 231607625123_Bedroom1.
The bed type value is changing from all caps to a more compact structure. For example TWIN_SINGLE_BED becomes TwinBed.
The description of available beds is being streamlined. For example, Twin/Single bed(s) - will now just read Twin Bed(s) - .

Schema change examples

Multi-unit vacation rental

This example shows a multi-unit vacation rental property consisting of three separate units, each with one bedroom.

Old schema

{
      "property_id": "49154578123",
      "vacation_rental": {
            "unit_configurations": {
                  "1": [
                        {
                              "quantity": 1,
                              "description": "King bed(s) - ",
                              "type": "KING_BED"
                        }
                  ],
                  "2": [
                        {
                              "quantity": 2,
                              "description": "Queen bed(s) - ",
                              "type": "QUEEN_BED"
                        },
                        {
                              "quantity": 1,
                              "description": "Sleep sofa/futon(s) - ",
                              "type": "SLEEP_SOFA_FUTON"
                        }
                  ],
                  "3": [
                        {
                              "quantity": 1,
                              "description": "Sleep sofa/futon(s) - ",
                              "type": "SLEEP_SOFA_FUTON"
                        }
                  ]
            }
      }
}

New schema

{
      "property_id": "491545781237",
      "vacation_rental": {
            "unit_configurations": {
                  "831607625124_Bedroom1": [
                        {
                              "quantity": 1,
                              "description": "King Bed(s) - ",
                              "type": "KingBed"
                        }
                  ],
                  "831607648123_Bedroom1": [
                        {
                              "quantity": 2,
                              "description": "Queen Bed(s) - ",
                              "type": "QueenBed"
                        },
                        {
                              "quantity": 1,
                              "description": "Futon(s) - ",
                              "type": "Futon"
                        }
                  ],
                  "231607641239123_Bedroom1": [
                        {
                              "quantity": 1,
                              "description": "Futon(s) - ",
                              "type": "Futon"
                        }
                  ]
            }
      }
}

Two-bedroom Vrbo property

This example shows a Vrbo property with two bedrooms.

Old schema

{
      "property_id": "721545781234",
      "vacation_rental": {
            "unit_configurations": {
                  "1": [
                        {
                              "quantity": 1,
                              "description": "King bed(s) - ",
                              "type": "KING_BED"
                        }
                  ],
                  "2": [
                        {
                              "quantity": 2,
                              "description": "Queen bed(s) - ",
                              "type": "QUEEN_BED"
                        },
                        {
                              "quantity": 1,
                              "description": "Sleep sofa/futon(s) - ",
                              "type": "SLEEP_SOFA_FUTON"
                        }
                  ]
            }
      }
}

New schema

{
      "property_id": "721545781234",
      "vacation_rental": {
            "unit_configurations": {
                  "6516076251239_Bedroom1": [
                        {
                              "quantity": 1,
                              "description": "King Bed(s) - ",
                              "type": "KingBed"
                        }
                  ],
                  "6516076251239_Bedroom2": [
                        {
                              "quantity": 2,
                              "description": "Queen Bed(s) - ",
                              "type": "QueenBed"
                        },
                        {
                              "quantity": 1,
                              "description": "Futon(s) - ",
                              "type": "Futon"
                        }
                  ]
            }
      }
}

If you have any questions about these changes or how they will affect your Rapid implementation, please reach out for support.