Amadeus · Schema
Hotel
Hotel Content
TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights
Properties
| Name | Type | Description |
|---|---|---|
| hotelId | string | Amadeus Property Code (8 chars) |
| chainCode | string | Brand (RT...) or Merchant (AD...) (Amadeus 2 chars Code) |
| brandCode | string | Brand (RT...) (Amadeus 2 chars Code). Small Properties distributed by Merchants may not have a Brand. Example - AD (Value Hotels) is the Provider/Merchant, and RT (Accor) is the Brand of the Property |
| dupeId | string | Unique Property identifier of the physical hotel. One physical hotel can be represented by different Providers, each one having its own `hotelID`. This attribute allows a client application to group t |
| name | string | Hotel Name |
| cityCode | string | Warning: The IATA city code associated to the hotel (not necessary the real Hotel City) |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/hotel-search-hotel-schema.json",
"title": "Hotel",
"description": "Hotel Content",
"type": "object",
"properties": {
"hotelId": {
"description": "Amadeus Property Code (8 chars)",
"example": "ADPAR001",
"type": "string",
"pattern": "^[A-Z0-9]{8}$"
},
"chainCode": {
"description": "Brand (RT...) or Merchant (AD...) (Amadeus 2 chars Code)",
"example": "AD",
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"brandCode": {
"description": "Brand (RT...) (Amadeus 2 chars Code). Small Properties distributed by Merchants may not have a Brand.\nExample - AD (Value Hotels) is the Provider/Merchant, and RT (Accor) is the Brand of the Property",
"example": "RT",
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"dupeId": {
"description": "Unique Property identifier of the physical hotel.\nOne physical hotel can be represented by different Providers, each one having its own `hotelID`.\nThis attribute allows a client application to group together hotels that are actually the same.",
"example": "501132260",
"type": "string"
},
"name": {
"description": "Hotel Name",
"example": "Hotel de Paris",
"type": "string"
},
"cityCode": {
"description": "Warning: The IATA city code associated to the hotel (not necessary the real Hotel City)",
"example": "PAR",
"type": "string",
"pattern": "^[A-Z]{3}$"
}
}
}
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-search-hotel"
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.