Hotel Search Hotel Offer Structure

{
  "$schema": "https://json-structure.org/draft/v0/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/hotel-search-hotel-offer-structure.json",
  "title": "HotelOffer",
  "description": "Hotel Offer",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "data type"
    },
    "id": {
      "type": "string",
      "description": "Unique identifier of this offer. Might be valid for a temporary period only."
    },
    "checkInDate": {
      "type": "string",
      "format": "date",
      "description": "check-in date of the stay (hotel local date). Format YYYY-MM-DD\nThe lowest accepted value is today date (no dates in the past)."
    },
    "checkOutDate": {
      "type": "string",
      "format": "date",
      "description": "check-out date of the stay (hotel local date). Format YYYY-MM-DD\nThe lowest accepted value is `checkInDate`+1."
    },
    "roomQuantity": {
      "type": "string",
      "description": "number of rooms (1-9)"
    },
    "rateCode": {
      "type": "string",
      "description": "Special Rate - Provider Response Code (3 chars)\nExamples\n\n  * RAC - Rack\n\n  * BAR - Best Available Rate\n\n  * PRO - Promotional\n\n  * COR - Corporate\n\n  * GOV - Government (qualified)\n\n  * AAA - AAA (qualified)\n\n  * BNB - Bed and Breakfast\n\n  * PKG - Package\n\n  * TVL - Travel Industry\n\n  * SPC - Special Promo Rate\n\n  * WKD - Weekend\n\n  * CON - Convention\n\n  * SNR - Senior (Europe) (qualified)\n\n  * ARP - AARP - American Association of Retired People (50+) (qualified)\n\n  * SRS - Senior (qualified)\n\n  * ROR - Room Only Rate (no breakfast)\n\n  * FAM - Family\n\n  * DAY - Day rate"
    },
    "rateFamilyEstimated": {
      "type": "object",
      "description": "The estimated rate code family of the offer. Grouping various rate plan codes that belongs to the same family and indicates the type of the rate"
    },
    "category": {
      "type": "string",
      "description": "Special Rate Category\nExamples:\n  ASSOCIATION\n  FAMILY_PLAN"
    },
    "description": {
      "type": "object",
      "description": "Specific type to convey a list of string for specific information type ( via qualifier) in specific character set, or language"
    },
    "commission": {
      "type": "object"
    },
    "boardType": {
      "type": "string",
      "description": "The included Breakfast/Meals"
    },
    "room": {
      "type": "object"
    },
    "guests": {
      "type": "object"
    },
    "price": {
      "type": "object",
      "description": "price information"
    },
    "policies": {
      "type": "object",
      "description": "Booking Rules"
    },
    "self": {
      "type": "string",
      "description": "A self link to the object. Use this to refresh the Offer price"
    }
  },
  "required": [
    "id",
    "rateCode",
    "room",
    "price"
  ]
}