Hotel Details

About 976 wordsAbout 3 min

2026-03-27

POST Hotel Details

This API is used to retrieve detailed information for a specified list of hotel IDs.

The default static information provided includes: hotel basic information, hotel policies, hotel facilities, and hotel details. For other static information, such as room information and image information, please contact your dedicated API account manager for configuration.

Please note that the images are sourced from suppliers and direct contracts. Proper copyright authorization for these images must be ensured, and the images must not pose any legal risks.

Endpoint

POST /hotel/details

Request Parameters

{
  "language": "en-US",
  "hotelIds": [100]
}

Name	Type	Required	Description
language	String	No	Response language
hotelIds	Array	Yes	List of hotel IDs (max 50 IDs)

Request Example

curl --location --request POST '{{domain}}/hotel/details' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "language": "en-US",
  "hotelIds": [100]
}'

Response Example

{
    "traceId": "00-059b901c7d78770657bcfa773c4de203-281f3469440212ab-01",
    "timestamp": "1774489926861",
    "data": [
        {
            "language": "en-US",
            "id": 100,
            "name": "The Algonquin Hotel Times Square, Autograph Collection",
            "location": {
                "country": {
                    "code": "US",
                    "name": "Usa"
                },
                "destination": {
                    "code": "178293",
                    "name": "New York (and vicinity)"
                },
                "coordinate": {
                    "longitude": -73.982284,
                    "latitude": 40.75601
                },
                "stateCode": "NY",
                "address": "59 W 44th St",
                "regions": [
                    {
                        "code": "2621",
                        "name": "New York"
                    },
                    ...
                ]
            },
            "telephone": "1-212-840-6800",
            "starRating": 4,
            "zipCode": "10036",
            "airportCode": "LGA",
            "category": {
                "code": "1",
                "name": "Hotel"
            },
            "description": "<p><b>Property Location</b><br/>With a stay at The Algonquin Hotel Times Square, Autograph Collection, you'll be centrally located in New York, within a 5-minute walk of 5th Avenue and Rockefeller Center.  This boutique hotel is 0.2 mi (0.3 km) from Bryant Park and 0.2 mi (0.4 km) from Times Square.</p><p><b>Rooms</b><br/>Make yourself at home in one of the 181 guestrooms featuring iPod docking stations and flat-screen televisions. Your pillowtop bed comes with premium bedding. Wireless internet access (surcharge) keeps you connected, and cable programming is available for your entertainment. Private bathrooms have designer toiletries and hair dryers.</p><p><b>Dining</b><br/>Enjoy a satisfying meal at Lobby serving guests of The Algonquin Hotel Times Square, Autograph Collection. Quench your thirst with your favorite drink at the bar/lounge.</p><p><b>Rec, Spa, Premium Amenities</b><br/>Take advantage of recreation opportunities such as a 24-hour fitness center, or other amenities including complimentary wireless internet access and wedding services. Additional features at this Edwardian hotel include tour/ticket assistance and a banquet hall.</p><p><b>Business, Other Amenities</b><br/>Featured amenities include a 24-hour business center, express check-out, and complimentary newspapers in the lobby. Planning an event in New York? This hotel has 4372 square feet (406 square meters) of space consisting of conference space and 6 meeting rooms.</p>",
            "policy": {
                "description": "<p><b>Special check-in instructions</b><br/>This property doesn't offer after-hours check-in. Front desk staff will greet guests on arrival at the property. Information provided by the property may be translated using automated translation tools.</p><p><b>Know Before You Go</b><br/><ul>  <li>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. </li><li>This property welcomes guests of all sexual orientations and gender identities (LGBTQ+ friendly).</li> </ul></p><p><b>Fees</b><br/><ul> <li>Fee for in-room wireless internet: USD 0.00 per night (rates may vary)</li><li>Valet parking fee: USD 90 per day</li><li>Pet fee: USD 125.00 per accommodation, per stay</li><li>Service animals are exempt from fees</li></ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax and are subject to change. </p></p><p><b>Mandatory Fees and Taxes</b><br/><p>You'll be asked to pay the following charges at the property. Fees may include applicable taxes:</p> <ul><li>Destination fee: USD 51.63 per accommodation, per night</li></ul> <p>We have included all charges provided to us by the property. </p></p>",
                "checkinFrom": "16:00:00",
                "checkoutTo": "12:00:00",
                "extraInfoList": [
                    {
                        "type": "Pets",
                        "description": "Pets allowed",
                        "value": "Pets allowed"
                    },
                    ...
                ]
            },
            "facilities": [
                {
                    "type": "HotelFacility",
                    "description": "Bar/lounge"
                },
                ...
            ],
            "rooms": [
                {
                    "id": 155446,
                    "name": "Standard Room"
                },
               ...
            ]
        }
    ]
}

Response Parameters

Field	Type	Required	Description
traceId	String	Yes	Unique request identifier
timestamp	String	Yes	Request timestamp
data	Array	No	List of hotel details

data

Field	Type	Required	Description
language	String	Yes	Language
id	Integer	Yes	Hotel ID
name	String	Yes	Hotel name
location	Object	Yes	Location info
telephone	String	No	Phone number
starRating	Double	No	Star rating
zipCode	String	No	Zip code
airportCode	String	No	Airport code
category	Object	No	Category info
description	String	No	Description
policy	Object	No	Policy info
facilities	Array	No	Facilities list
images	Array	No	Images list
rooms	Array	No	Room information

location

Field	Type	Required	Description
country.code	String	Yes	Country code
country.name	String	Yes	Country name
destination.code	String	Yes	Destination code
destination.name	String	Yes	Destination name
coordinate.longitude	Float	Yes	Longitude
coordinate.latitude	Float	Yes	Latitude
address	String	Yes	Address
regions.code	String	Yes	Region code
regions.name	String	Yes	Region name

policy

Field	Type	Required	Description
description	String	No	Policy description
checkinFrom	String	Yes	Check-in time
checkoutTo	String	Yes	Check-out time
extraInfoList	Array	Yes	Additional info
extraInfoList.type	String	Yes	Type
extraInfoList.description	String	Yes	Description
extraInfoList.value	String	Yes	Value

facilities

Field	Type	Required	Description
type	String	No	Type
description	String	No	Description
value	String	No	Value

rooms

Field	Type	Required	Description
id	Integer	No	Room ID
name	String	No	Room name
maxOccupancy	Integer	No	Maximum occupancy
size	String	No	Room size
hasWifi	Boolean	No	Whether Wi-Fi is available