Skip to main content

Hotel Static Data Endpoint

Fetches paginated hotel static listings.

  • Endpoint: /api/v1/tourmind/hotels
  • Method: GET

Headers

HeaderValueRequiredDescription
Partner-Access-TokenBase64 StringYesYour encrypted AES-256 time-sensitive token.
Acceptapplication/jsonYes

Query Parameters

ParameterTypeRequiredDescription
pageIntegerOptionalPage number.
per_pageIntegerOptionalNumber of records per page.

Sample Response

{
"result": 1,
"message": "success",
"data": {
"hotels": [
{
"id": 1,
"hotel_code": 1352202,
"slug": "hotel-piazza-1352202",
"name": "Hotel Piazza",
"star_rating": 3,
"city": "Peshkopi",
"country_code": "AL",
"address": "Bulevard Elez Isufi",
"latitude": 41.685264,
"longitude": 20.428069,
"main_image": null,
"is_active": true,
"room_types_count": 5
}
],
"pagination": {
"current_page": 1,
"per_page": 5,
"total": 542848,
"last_page": 108570
}
}
}

Response Fields

FieldTypeDescription
resultInteger1 for success, 2 for failed.
messageStringResponse message.
data.hotelsArrayHotel list.
hotel_codeIntegerProvider hotel code.
slugStringHotel slug used for detail and room endpoints.
star_ratingIntegerHotel star rating.
country_codeStringISO 3166-1 alpha-2 country code.
main_imageString or nullHotel main image URL.
room_types_countIntegerNumber of room types available in static data.
data.paginationObjectPagination details.