Amadeus Reservations · Schema
HotelOrder
An Hotel Order is one or several hotel bookings done for a set of guest.
BookingFlightsHotelsReservationsTravel
Properties
| Name | Type | Description |
|---|---|---|
| hotelBookings | array | Array of hotel-bookings |
| associatedRecords | array | Reference and origin of the hotel order record |
| self | string | Self URL for retrieving the Hotel Order |
| type | string | Resource name - Is set to "hotel-order" |
| guests | object | |
| id | string | Id of the hotelorder. It is a crucial information and must be stored in the client system as it is mandatory to provide it in any further step such as cancel or retrieve. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/amadeus-reservations/refs/heads/main/json-schema/hotel-booking-hotel-order-schema.json",
"title": "HotelOrder",
"description": "An Hotel Order is one or several hotel bookings done for a set of guest.",
"type": "object",
"properties": {
"hotelBookings": {
"type": "array",
"uniqueItems": true,
"minItems": 1,
"description": "Array of hotel-bookings",
"items": {
"$ref": "#/definitions/HotelBooking"
}
},
"associatedRecords": {
"type": "array",
"uniqueItems": false,
"minItems": 1,
"description": "Reference and origin of the hotel order record",
"items": {
"type": "object",
"properties": {
"reference": {
"type": "string",
"description": "Record locator of the PNR in which the hotel order is stored in Amadeus GDS.",
"example": "ABCDEF",
"minLength": 6,
"maxLength": 6,
"pattern": "^[A-Z0-9]{6}$"
},
"originSystemCode": {
"type": "string",
"minLength": 1,
"description": "As the reference is a PNR record locator, the originSystemCode is set to GDS.",
"example": "GDS"
}
},
"required": [
"reference",
"originSystemCode"
]
}
},
"self": {
"type": "string",
"minLength": 1,
"description": "Self URL for retrieving the Hotel Order"
},
"type": {
"type": "string",
"minLength": 1,
"description": "Resource name - Is set to \"hotel-order\""
},
"guests": {
"$ref": "#/definitions/Guests"
},
"id": {
"type": "string",
"description": "Id of the hotelorder. \nIt is a crucial information and must be stored in the client system as it is mandatory to provide it in any further step such as cancel or retrieve.",
"minLength": 1,
"pattern": "[A-Za-z0-9+/=]",
"example": "12312"
}
},
"required": [
"hotelBookings",
"associatedRecords",
"self",
"type",
"guests",
"id"
]
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/hotel-booking-hotel-order"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.