Hotel Property Details
This page covers retrieving information about a specific hotel property and its rooms.
Hotel Property Details
GET /hotel/[sessionId]/property/[propertyId]
This endpoint retrieves information about a specific hotel property, including detailed descriptions, amenities, policies, check-in instructions, and other property-specific information. The propertyId
parameter should be the public identifier of a hotel from the availability results.
🛎 Use the
public
ID from a hotel availability result to fetch detailed property information including amenities, policies, and check-in procedures.
Request
GET /hotel/[sessionId]/property/[propertyId]
Response
Returns a Hotel Property Details Response with comprehensive hotel information.
{
"hotel_information": {
"hotel_name": "Fairmont Royal York",
"rating": "4",
"distance": null,
"images": [
{
"src": "https://i.travelapi.com/lodging/1000000/20000/17300/17289/ca60300e_z.jpg",
"alt": "Primary image"
},
{
"src": "https://i.travelapi.com/lodging/1000000/20000/17300/17289/4e7fad5f_z.jpg",
"alt": "Lobby"
}
],
"chain_code": "-1",
"hotel_code": "17289",
"master_chain_name": "Accor Hotel Brands",
"master_chain_code": "RT",
"address": {
"city_name": "Toronto",
"country_code": "CA",
"address": "100 Front St West",
"city_code": null,
"postal_code": "M5J1E3",
"phone": [
"1-416-368-2511"
],
"fax": [
"1-416-368-2884"
],
"location": {
"latitude": "43.645954",
"longitude": "-79.381454",
}
}
},
"check_in_information": {
"check_in": [
"2025-10-08 16:00:00",
"2025-10-09 02:00:00"
],
"check_out": [
"2025-10-12 12:00:00"
],
"instructions": [
"<ul><li>Extra-person charges may apply and vary depending on property policy</li><li>Government-issued photo identification and a credit card, debit card, or cash deposit may be required at check-in for incidental charges</li><li>Special requests are subject to availability upon check-in and may incur additional charges; special requests cannot be guaranteed</li><li>This property accepts credit cards; cash is not accepted</li><li>Cashless transactions are available</li><li>Safety features at this property include a smoke detector</li><li>This property affirms that it follows the cleaning and disinfection practices of ALLSAFE (Accor Hotels)</li><li>Please note that cultural norms and guest policies may differ by country and by property; the policies listed are provided by the property</li> </ul>"
],
"special_instructions": [
"Front desk staff will greet guests on arrival at the property. For any questions, please contact the property using the information on the booking confirmation. Guests should contact the hotel about reaching the property during road construction using the number on the booking confirmation."
]
},
"hotel_amenities": [
"Dry cleaning/laundry service",
"Gift shops or newsstand",
"Shopping on site",
"Comprehensive recycling policy",
"Bulk dispenser for toiletries",
"Proposal/romance packages available",
"Vegetarian breakfast available",
"Biodegradable/compostable stirrers",
"No single-use plastic straws",
"No single-use plastic soda bottles",
"Number of meeting rooms - 40",
"No single-use plastic stirrers",
"Conference space size (meters) - 6503",
"Reusable cups only",
"Wired internet access - surcharge",
"Reusable tableware only",
"Biodegradable/compostable straws",
"WiFi (surcharge)",
"Limo or town car service available",
"Sailing nearby",
"No single-use plastic water bottles",
"Number of bars/lounges - 3",
"Number of indoor pools - 1",
"Assistive listening devices available",
"Tours/ticket assistance",
"Internet access - wireless"
],
"descriptions": [
{
"title": "amenities",
"text": "Pamper yourself with a visit to the spa, which offers body treatments and facials. You're sure to appreciate the recreational amenities, including a health club, an indoor pool, and a sauna. This hotel also features wireless internet access (surcharge), concierge services, and gift shops/newsstands."
},
{
"title": "dining",
"text": "Enjoy Regional cuisine at REIGN Restaurant + Bar, one of the hotel's 3 restaurants, or stay in and take advantage of the room service (during limited hours). Snacks are also available at the coffee shop/cafe. Need to unwind? Take a break with a tasty beverage at one of the 3 bars/lounges. Full breakfasts are served on weekdays from 6:30 AM to 11:00 AM and on weekends from 6:30 AM to 11:30 AM for a fee."
},
{
"title": "renovations",
"text": "The following facilities are closed on Sunday: <ul><li>Full-service spa</li></ul>"
},
{
"title": "business_amenities",
"text": "Featured amenities include wired internet access (surcharge), limo/town car service, and express check-in. Planning an event in Toronto? This hotel has 70000 square feet (6503 square meters) of space consisting of conference space and 40 meeting rooms."
},
{
"title": "rooms",
"text": "Make yourself at home in one of the 1343 guestrooms featuring minibars and LCD televisions. Your pillowtop bed comes with premium bedding. Digital programming and video-game consoles are provided for your entertainment, with wired and wireless internet access available for a surcharge. Private bathrooms with bathtubs or showers feature designer toiletries and hair dryers."
},
{
"title": "attractions",
"text": "Distances are displayed to the nearest 0.1 mile and kilometer. <br /> <p>PATH Underground Shopping Mall - 0.1 km / 0.1 mi <br /> The Path - 0.1 km / 0.1 mi <br /> Toronto-Dominion Centre - 0.3 km / 0.2 mi <br /> Hockey Hall of Fame - 0.4 km / 0.3 mi <br /> Roy Thomson Hall - 0.5 km / 0.3 mi <br /> Scotiabank Arena - 0.5 km / 0.3 mi <br /> Meridian Hall - 0.5 km / 0.3 mi <br /> Metro Toronto Convention Centre - 0.5 km / 0.3 mi <br /> Canada Permanent Building - 0.6 km / 0.4 mi <br /> Royal Alexandra Theatre - 0.7 km / 0.5 mi <br /> Four Seasons Centre - 0.8 km / 0.5 mi <br /> Rogers Centre - 0.8 km / 0.5 mi <br /> Ripley's Aquarium of Canada - 0.8 km / 0.5 mi <br /> Princess of Wales Theatre - 0.8 km / 0.5 mi <br /> CN Tower - 0.8 km / 0.5 mi <br /> </p><p>The nearest airports are:<br />Billy Bishop Toronto City Airport (YTZ) - 3.2 km / 2 mi<br /> Toronto Pearson Intl. Airport (YYZ) - 27.1 km / 16.9 mi<br /> </p><p></p>"
}
],
"policies": [
{
"title": "know_before_you_go",
"text": " Pool access available from 6:00 AM to 10:00 PM.Reservations are required for spa treatments. Reservations can be made by contacting the hotel prior to arrival, using the contact information on the booking confirmation. Children 18 years old and younger stay free when occupying the parent or guardian's room, using existing bedding. The property has connecting/adjoining rooms, which are subject to availability and can be requested by contacting the property using the number on the booking confirmation. The property allows pets in specific rooms only and has other pet restrictions (surcharges apply and can be found in the Fees section). Guests can arrange to bring pets by contacting the property directly, using the contact information on the booking confirmation. Cashless payment methods are available for all transactions.Contactless check-in and contactless check-out are available.This property welcomes guests of all sexual orientations and gender identities (LGBTQ+ friendly). "
}
],
"fees": null,
"expireAt": "2025-09-24T18:44:06.430Z",
"public": "9607a431-69e5-4f40-8e18-503612ad0c72",
"createdAt": "2025-09-24T16:45:16.434Z",
"updatedAt": "2025-09-24T16:45:16.434Z"
}
⛳ Property details include the same information as the availability response, but with additional context like amenities and policies to help with booking decisions.
Possible Errors
Status Code | Error | Reason | Reason Code |
---|---|---|---|
401 | Unauthorized | Invalid or missing API key | |
404 | Invalid Key Exception | API key is invalid or inactive | ORX_INVALID_API_KEY |
404 | [Session Not Found] | The specified session ID does not exist or has expired | ORX_SESSION_NOT_FOUND |
400 | [Validation Error] | Invalid query parameters or search string | ORX_VALIDATION_EXCEPTION |
500 | NDCx Internal Error | Unknown | ORX_UNKNOWN_ERROR |
Hotel Rooms and Rate Details
GET /hotel/[sessionId]/rooms/[propertyId]
Returns detailed information about available room and associated rate options with enhanced pricing breakdowns.
🛎 Use the
public
ID from a hotel availability properties.
Request
GET /hotel/[sessionId]/rooms/[propertyId]
Response
Returns an array of Hotel Room Details with comprehensive room and rate information.
[
{
"type": {
"name": "Guest room",
"code": "42"
},
"bed_types": [
{
"type": "Queen",
"count": 2
}
],
"max_occupancy": null,
"non_smoking": null,
"amenities": [],
"images": null,
"rates": [
{
"rate_description": {
"start_date": "2025-10-08 00:00:00",
"end_date": "2025-10-12 00:00:00",
"tax_inclusive": true,
"number_of_nights": 4,
"refundable": true,
"commissionable": false,
"discount_codes": [],
"pay_at_hotel": true,
"is_disabled": false,
"payment_owner": "VENDOR",
"cancellation": {
"refundable": true,
"penalties": [
{
"amount": "0.00",
"currency": "CAD",
"deadline": "2025-10-07T15:00:00",
"percentage": null
},
{
"amount": "225.00",
"currency": "CAD",
"deadline": "2025-10-08T15:00:00",
"percentage": "50"
},
{
"amount": "450.00",
"currency": "CAD",
"deadline": "2025-10-08T23:59:59",
"percentage": "100"
}
]
}
},
"rate_price": null,
"local_rate_price": {
"fees": {
"total": "0.00",
"description": null,
"breakdown": []
},
"taxes": {
"total": "347.21",
"description": null,
"breakdown": []
},
"average_nightly_rate": "470.80",
"average_nightly_rate_before_tax": "384.00",
"amount_after_tax": "1883.21",
"amount_before_tax": "1536.00",
"currency": "CAD"
},
"expireAt": "2025-09-24T18:44:06.430Z",
"createdAt": "2025-09-24T17:11:54.519Z",
"public": "f6937840-8f61-4159-a932-d62795adac2a"
},
{
"rate_description": {
"start_date": "2025-10-08 00:00:00",
"end_date": "2025-10-12 00:00:00",
"tax_inclusive": true,
"number_of_nights": 4,
"refundable": true,
"commissionable": false,
"discount_codes": [],
"pay_at_hotel": true,
"is_disabled": false,
"payment_owner": "VENDOR"
},
"rate_price": null,
"local_rate_price": {
"fees": {
"total": "0.00",
"description": null,
"breakdown": []
},
"taxes": {
"total": "374.33",
"description": null,
"breakdown": []
},
"average_nightly_rate": "507.58",
"average_nightly_rate_before_tax": "414.00",
"amount_after_tax": "2030.33",
"amount_before_tax": "1656.00",
"currency": "CAD"
},
"expireAt": "2025-09-24T18:44:06.430Z",
"createdAt": "2025-09-24T17:11:54.520Z",
"public": "223912d8-31c6-4dce-92dc-4a5067b49296"
}
],
"expireAt": "2025-09-24T18:44:06.430Z",
"public": "eaa8a92c-9ffb-4c58-856a-e25ed45091ba",
"createdAt": "2025-09-24T17:11:54.599Z",
"updatedAt": "2025-09-24T17:11:54.599Z"
},
{
"type": {
"name": "Guest room",
"code": "42"
},
"bed_types": [
{
"type": "King",
"count": 1
}
],
"max_occupancy": null,
"non_smoking": null,
"amenities": [
"Balcony Lanai Terrace"
],
"images": [
{
"src": "https://example.com/room-deluxe-king-1.jpg",
"alt": "Deluxe King Room - Main View"
},
{
"src": "https://example.com/room-deluxe-king-bathroom.jpg",
"alt": "Deluxe King Room - Bathroom"
}
],
"rates": [
{
"rate_description": {
"start_date": "2025-10-08 00:00:00",
"end_date": "2025-10-12 00:00:00",
"tax_inclusive": true,
"number_of_nights": 4,
"refundable": true,
"commissionable": false,
"discount_codes": [],
"pay_at_hotel": true,
"is_disabled": false,
"payment_owner": "VENDOR"
},
"rate_price": null,
"local_rate_price": {
"fees": {
"total": "0.00",
"description": null,
"breakdown": []
},
"taxes": {
"total": "428.60",
"description": null,
"breakdown": []
},
"average_nightly_rate": "581.15",
"average_nightly_rate_before_tax": "474.00",
"amount_after_tax": "2324.60",
"amount_before_tax": "1896.00",
"currency": "CAD"
},
"expireAt": "2025-09-24T18:44:06.430Z",
"createdAt": "2025-09-24T17:11:54.549Z",
"public": "6e4872f8-3f74-447b-b77d-2a7985009b95"
}
],
"expireAt": "2025-09-24T18:44:06.430Z",
"public": "593130b5-6a25-42f9-b20e-6bfe867b05d4",
"createdAt": "2025-09-24T17:11:54.602Z",
"updatedAt": "2025-09-24T17:11:54.602Z"
}
]
Possible Errors
Status Code | Error | Reason | Reason Code |
---|---|---|---|
401 | Unauthorized | Invalid or missing API key | |
404 | Invalid Key Exception | API key is invalid or inactive | ORX_INVALID_API_KEY |
404 | [Session Not Found] | The specified session ID does not exist or has expired | ORX_SESSION_NOT_FOUND |
400 | [Validation Error] | Invalid query parameters or search string | ORX_VALIDATION_EXCEPTION |
500 | NDCx Internal Error | Unknown | ORX_UNKNOWN_ERROR |