POST
/hotelsSearch Hotels
Implementation Notes
This API call retrieves a list of all hotels available in the RatesAPI database for rate retrieval. If a hotel you wish to retrieve rate for is not listed, please send the request using POST /Hotelmaprequest endpoint. We will make efforts to add the hotel to our database within 24 to 72 business hours.POST
/hotelsParameter Details
| Name | In | Type | Required | Description |
|---|---|---|---|---|
body | body | Optional | none | |
» hotelname | body | string | Optional | none |
» country | body | string | Optional | none |
» city | body | number | Optional | none |
» state | body | string | Optional | none |
» zip | body | string | Optional | none |
» keyword | body | string | Optional | none |
» pagenumber | body | number | Optional | none |
» pagesize | body | number | Optional | none |
» geolocation | body | object | Optional | none |
»» latitude | body | string | Optional | none |
»» longitude | body | string | Optional | none |
»» radius | body | string | Optional | none |
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Success | None |
| 400 | Bad Request | Bad Request | None |
| 401 | Unauthorized | Authentication Failed or Account validity expired | None |
| 500 | Internal Server Error | Internal server error | None |
Example Request
# You can also use wget
curl -X POST /hotels \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
Body Parameter
{
"hotelname": "Hilton",
"country": "United States Of America",
"city": "Las Vegas"
}
Example responses
200 Response
{
"hotelcode": 0,
"hotelname": "string",
"address": "string",
"city": "string",
"state": "string",
"zip": "string",
"country": "string",
"starrating": "string",
"lat": 0,
"lng": 0
}Need Support?
Our team is here to help you integrate and make the most of our APIs. Get in touch for technical support, custom solutions, or any questions.