{ "$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" ] }