Hotel Static Data Endpoint
Fetches paginated hotel static listings.
- Endpoint:
/api/v1/tourmind/hotels - Method:
GET
Headers
| Header | Value | Required | Description |
|---|---|---|---|
Partner-Access-Token | Base64 String | Yes | Your encrypted AES-256 time-sensitive token. |
Accept | application/json | Yes |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page | Integer | Optional | Page number. |
per_page | Integer | Optional | Number 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
| Field | Type | Description |
|---|---|---|
result | Integer | 1 for success, 2 for failed. |
message | String | Response message. |
data.hotels | Array | Hotel list. |
hotel_code | Integer | Provider hotel code. |
slug | String | Hotel slug used for detail and room endpoints. |
star_rating | Integer | Hotel star rating. |
country_code | String | ISO 3166-1 alpha-2 country code. |
main_image | String or null | Hotel main image URL. |
room_types_count | Integer | Number of room types available in static data. |
data.pagination | Object | Pagination details. |