Amadeus · JSON Structure

Hotel Booking Hotel Product Structure

Hotel Offer

Type: object Properties: 11 Required: 3
TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Hotel Booking Hotel Product Structure is a JSON Structure definition published by Amadeus, describing 11 properties, of which 3 are required. It conforms to the https://json-structure.org/draft/v0/schema meta-schema.

Properties

checkInDate checkOutDate roomQuantity rateCode category commission room guests price policies rateFamilyEstimated

Meta-schema: https://json-structure.org/draft/v0/schema

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/draft/v0/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/hotel-booking-hotel-product-structure.json",
  "title": "HotelProduct",
  "description": "Hotel Offer\n",
  "type": "object",
  "properties": {
    "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": "integer",
      "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\n"
    },
    "category": {
      "type": "string",
      "description": "Special Rate Category\nExamples:\n  ASSOCIATION\n  FAMILY_PLAN\n"
    },
    "commission": {
      "type": "object"
    },
    "room": {
      "type": "object"
    },
    "guests": {
      "type": "object"
    },
    "price": {
      "type": "string",
      "description": "price information"
    },
    "policies": {
      "type": "object",
      "description": "Booking Rules"
    },
    "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"
    }
  },
  "required": [
    "rateCode",
    "room",
    "price"
  ]
}