Property Policies

File Content and Purpose

This file contains data elements that are specific to the policies, rules, and fees of each lodging property.

File Format

Inside the .zip file you will find 6 compressed .jsonl files. Each .jsonl file will contain a collection of separate, valid JSON objects, one per line. The break between files will always fall between JSON objects, so you can assume all JSON files are complete.

The grouping of the properties into the files is random, so you will need to parse all 6 files to find all properties of a given type or in a given location, etc.

File Update Schedule

This file is currently scheduled to be updated every Wednesday, with a new version published at 1am Pacific time each week.

File Download Link

Downloading the full content file will require an Expedia API key with permissions added for static data download.

Sample File Download

You can download a sample file that will give you an idea of the content and structure of the full Policies File download:

• Download SAMPLE Policies Data File

Complete File Download

To download the complete Policies Data File, please follow the instructions on the page linked below:

• Download COMPLETE Policies Data File

Sample Property Policies Record

Below is a sample file showing the structure of the policies listing for a single property.

{
    "propertyId": {
      "expedia": "57490950",
      "hcom": "1840710400",
      "vrbo": "321.2045823.2610343"
    },
    "propertyType": {
      "id": 16,
      "name": "Apartment"
    },
    "country": "United States",
    "checkInStartTime": "4:00 PM",
    "checkOutTime": "10:00 AM",
    "checkInPolicy": [
      "Check-in time starts at 4:00 PM",
      "Minimum check-in age - 23 "
    ],
    "checkOutPolicy": [
      "Check-out before 10:00 AM"
    ],
    "minimumAge": "23",
    "petPolicy": [
      "Pets allowed"
    ],
    "childrenAndExtraBedPolicy": [
      "Children are welcome."
    ],
    "checkInInstructions": [
      "You will receive an email from the host with check-in and check-out instructions"
    ],
    "specialInstructions": [
      "Extra-person charges may apply and vary depending on property policy",
      "Government-issued photo identification and a credit card, debit card, or cash deposit may be required at check-in for incidental charges",
      "Special requests are subject to availability upon check-in and may incur additional charges; special requests cannot be guaranteed",
      "Onsite parties or group events are strictly prohibited",
      "Safety features at this property include a carbon monoxide detector, a fire extinguisher, a smoke detector, a first aid kit, and a deadbolt lock",
      "This property is managed through our partner, Vrbo. You will receive an email from Vrbo with a link to a Vrbo account, where you can change or cancel your reservation"
    ],
    "paymentPolicy": {
      "localCurrency": "USD"
    }
  }

Items to Note:

• HTML Formatting — As explained elsewhere, since this data is gathered from multiple sources, there is a mix of formatted and non-formatted elements.
• Element Consistency — You will notice that all values are delivered as strings. This is because nearly all of this data is entered by the partners themselves, so it often does not have the consistency that Expedia would enforce for internal content.
• Vacation Rental Policies — The data in this section is particularly important for vacation rentals, as the check-in process and rules of stay may be unique to this property.