Hotels

Hotels

get
Search hotels

https://[environment].katanox.com/v0/hotels
Get a list of hotels for a certain city-date-occupancy combination
Request
Response
Request
Headers
Authorization
required
string
Bearer <api key>
Query Parameters
city
required
string
The city to search in (e.g. Berlin)
adults
required
integer
The number of adults in the room
children
required
integer
The number of children in the room
check_in
required
string
The date of check in using the ISO 8601 format (YYYY-MM-DD)
check_out
required
string
The date of check out using the ISO 8601 format (YYYY-MM-DD)
Response
200: OK
Hotels found.
{
"availability": [
{
"hotel_id": "EY53D76G",
"room_id": "1O5DKN0Q",
"rate_plan_id": "W6NWY5MG",
"currency": "EUR",
"price": 120
},
{
"hotel_id": "EY53D76G",
"room_id": "1O5DKN0Q",
"rate_plan_id": "PEN8E7MX",
"currency": "EUR",
"price": 160
},
{
"hotel_id": "EY53D76G",
"room_id": "PEN8E7MX",
"rate_plan_id": "627G1NWJ",
"currency": "EUR",
"price": 220
}
],
"hotels": [
{
"id": "EY53D76G",
"name": "Hotel Berlin",
"type": {
"name": "Hotel"
},
"description": "The comfortable Hotel Berlin is situated in a quiet part of the lively neighbourhood of Mitte. Just around the corner you will find Berlin's popular Hackescher Höfe with their small boutiques and coffee bars, just next to the cities most hip and happening shopping area. For lovers of art and culture the Museum Insel is just a 5 minutes walk and for all foodies we have an endless list of Berlin's best restaurants within a 10 minute walking radius.\r\n\r\nPlan your day in this metropolis, while enjoying a lovely breakfast at our penthouse restaurant with an amazing view of the surrounding area. Can you spot the Fernsehturm while drinking your 'Kaffee\"?",
"address_line_1": "Friedrichstraße 79-80",
"address_line_2": "",
"postcode": "10117",
"city": "Berlin",
"country": "Germany",
"location": {
"latitude": 52.5171533,
"longitude": 13.3797725
},
"phone_number": "00344569852130",
"email": "[email protected]",
"currency": "EUR",
"star_rating": 5,
"images": [
{
"tag": "Featured",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/EY53D76G/media/image-0-20201022T202653109610.jpg",
"width": 1981,
"height": 1321
}
],
"translations": [
{
"locale": "nl",
"name": "Hotel Berlin",
"description": "Het comfortabele Hotel Berlin ligt in een rustig deel van de levendige wijk Mitte. Om de hoek vind je de populaire Hackescher Höfe van Berlijn met hun kleine boetiekjes en koffiebars, net naast de meest hippe en levendige winkelstraten van de stad. Voor liefhebbers van kunst en cultuur is het Museum Insel slechts 5 minuten lopen en voor alle fijnproevers hebben we een eindeloze lijst van de beste restaurants van Berlijn binnen een straal van 10 minuten lopen.\r\n\r\nPlan uw dag in deze metropool, terwijl u geniet van een heerlijk ontbijt in ons penthouse restaurant met een waanzinnig uitzicht over de omgeving. Kun je de Fernsehturm spotten terwijl je je 'Kaffee' drinkt?"
}
],
"facilities": [
{
"category": "Safety features",
"name": "Hand sanitizer in guest accommodation and key areas"
},
{
"category": "Safety features",
"name": "First aid kit available "
},
{
"category": "Physical distancing",
"name": "Contactless check-in/check-out"
},
{
"category": "Physical distancing",
"name": "Cashless payment available"
},
{
"category": "Cleaning",
"name": "Lines, towels and laundry washed in accordance with local authority guideless"
},
{
"category": "Cleaning",
"name": "Guest accommodation sealed after cleaning"
},
{
"category": "Pool and wellness",
"name": "Spa Facilities"
},
{
"category": "Transport",
"name": "Secured parking"
},
{
"category": "Transport",
"name": "Street parking"
},
{
"category": "Reception services",
"name": "Tickets to attractions or shows"
}
]
}
],
"rate_plans": [
{
"id": "PEN8E7MX",
"hotel_id": "EY53D76G",
"name": "Flexible",
"description": "Stay fully flexible with free cancellation until midnight one day prior to arrival. Just put your CC on file to guarantee the booking.",
"services": [
{
"id": "EY53D76G",
"name": "Breakfast",
"description": "Enjoy fresh fruit, just-baked viennoiseries, or a hearty morning meal.",
"price": 15,
"pricing_unit": "Person"
}
],
"cancellation_policy": {
"name": "Flexible",
"description": "Free cancellation until check-in",
"charge_type": "percentage",
"amount": 100
},
"no_show_policy": {
"name": "Non Refundable",
"description": "No free no-show",
"charge_type": "percentage",
"amount": 100
},
"translations": []
},
{
"id": "627G1NWJ",
"hotel_id": "EY53D76G",
"name": "Flexible",
"description": "Stay fully flexible with free cancellation until midnight one day prior to arrival. Just put your CC on file to guarantee the booking.",
"services": [],
"cancellation_policy": {
"name": "Flexible",
"description": "Free cancellation until check-in",
"charge_type": "percentage",
"amount": 100
},
"no_show_policy": {
"name": "Non Refundable",
"description": "No free no-show",
"charge_type": "percentage",
"amount": 100
},
"translations": []
},
{
"id": "W6NWY5MG",
"hotel_id": "EY53D76G",
"name": "Non Refundable",
"description": "Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
"services": [],
"cancellation_policy": {
"name": "Non Refundable",
"description": "No free cancellation",
"charge_type": "percentage",
"amount": 100
},
"no_show_policy": {
"name": "Non Refundable",
"description": "No free no-show",
"charge_type": "percentage",
"amount": 100
},
"translations": []
}
],
"rooms": [
{
"id": "1O5DKN0Q",
"hotel_id": "EY53D76G",
"name": "Single",
"description": "Nice and comfortable room with shower and single bed. There is a spacious desk available in the room, your own coffee machine, and a comfortable sofa to enjoy the view or watch some tv from.",
"beds": [
{
"name": "Single Bed(s)",
"occupancy": 1,
"number_of_beds": 1
}
],
"images": [
{
"tag": "",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/OWYDOG7Q/image-0-20201021T193542202369.jpg",
"width": 1024,
"height": 683
},
{
"tag": "Featured",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/OWYDOG7Q/image-1-20201021T193542509269.jpg",
"width": 1024,
"height": 683
},
{
"tag": "",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/OWYDOG7Q/image-2-20201021T193542731962.jpg",
"width": 799,
"height": 533
},
{
"tag": "",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/OWYDOG7Q/image-3-20201021T193542844116.jpg",
"width": 800,
"height": 536
}
],
"translations": [],
"amenities": []
},
{
"id": "PEN8E7MX",
"hotel_id": "EY53D76G",
"name": "Double",
"description": "Big room with a whirlpool and kingsize bed, a tv and your own coffee machine. There is a spacious desk in the room to work from or you can just relax on the sofa and enjoy your view over the bustling city of Berlin.",
"beds": [
{
"name": "King Bed(s)",
"occupancy": 2,
"number_of_beds": 1
}
],
"images": [
{
"tag": "Featured",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/MW850GO3/image-0-20201021T193623101300.jpg",
"width": 1024,
"height": 683
},
{
"tag": "",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/MW850GO3/image-1-20201021T193623437235.jpg",
"width": 1024,
"height": 683
},
{
"tag": "",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/MW850GO3/image-2-20201021T193623558588.jpg",
"width": 799,
"height": 533
},
{
"tag": "",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/MW850GO3/image-3-20201021T193623710983.jpg",
"width": 800,
"height": 536
}
],
"translations": [],
"amenities": []
}
]
}
404: Not Found
No hotels found matching this query.
{ "message": "Ain't no cake like that."}

get
Get Hotel

https://[environment].katanox.com/v0/hotels/:id
Get information about a specific hotel by providing its unique ID. Please note that this endpoint does not provide availability details.
Request
Response
Request
Path Parameters
id
required
string
The ID of the hotel
Headers
Authorization
required
string
Bearer <api key>
Response
200: OK
{
"id": "EY53D76G",
"name": "Hotel Berlin",
"type": {
"name": "Hotel"
},
"description": "The comfortable Hotel Berlin is situated in a quiet part of the lively neighbourhood of Mitte. Just around the corner you will find Berlin's popular Hackescher Höfe with their small boutiques and coffee bars, just next to the cities most hip and happening shopping area. For lovers of art and culture the Museum Insel is just a 5 minutes walk and for all foodies we have an endless list of Berlin's best restaurants within a 10 minute walking radius.\r\n\r\nPlan your day in this metropolis, while enjoying a lovely breakfast at our penthouse restaurant with an amazing view of the surrounding area. Can you spot the Fernsehturm while drinking your 'Kaffee\"?",
"address_line_1": "Friedrichstraße 79-80",
"address_line_2": "",
"postcode": "10117",
"city": "Berlin",
"country": "Germany",
"location": {
"latitude": 52.5171533,
"longitude": 13.3797725
},
"phone_number": "00344569852130",
"email": "[email protected]",
"currency": "EUR",
"star_rating": 5,
"images": [
{
"tag": "Featured",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/EY53D76G/media/image-0-20201022T202653109610.jpg",
"width": 1981,
"height": 1321
}
],
"translations": [
{
"locale": "nl",
"name": "Hotel Berlin",
"description": "Het comfortabele Hotel Berlin ligt in een rustig deel van de levendige wijk Mitte. Om de hoek vind je de populaire Hackescher Höfe van Berlijn met hun kleine boetiekjes en koffiebars, net naast de meest hippe en levendige winkelstraten van de stad. Voor liefhebbers van kunst en cultuur is het Museum Insel slechts 5 minuten lopen en voor alle fijnproevers hebben we een eindeloze lijst van de beste restaurants van Berlijn binnen een straal van 10 minuten lopen.\r\n\r\nPlan uw dag in deze metropool, terwijl u geniet van een heerlijk ontbijt in ons penthouse restaurant met een waanzinnig uitzicht over de omgeving. Kun je de Fernsehturm spotten terwijl je je 'Kaffee' drinkt?"
}
],
"facilities": [
{
"category": "Safety features",
"name": "Hand sanitizer in guest accommodation and key areas"
},
{
"category": "Safety features",
"name": "First aid kit available "
},
{
"category": "Physical distancing",
"name": "Contactless check-in/check-out"
},
{
"category": "Physical distancing",
"name": "Cashless payment available"
},
{
"category": "Cleaning",
"name": "Lines, towels and laundry washed in accordance with local authority guideless"
},
{
"category": "Cleaning",
"name": "Guest accommodation sealed after cleaning"
},
{
"category": "Pool and wellness",
"name": "Spa Facilities"
},
{
"category": "Transport",
"name": "Secured parking"
},
{
"category": "Transport",
"name": "Street parking"
},
{
"category": "Reception services",
"name": "Tickets to attractions or shows"
}
]
}

get
Get Hotel Availability

https://[environment].katanox.com/v0/hotels/:id/availability
Get the availability of a single hotel for certain dates/occupancy.
Request
Response
Request
Path Parameters
adults
required
integer
The number of adults in the room
children
required
integer
The number of children in the room
check_in
required
string
The date of check in using the ISO 8601 format (YYYY-MM-DD)
check_out
required
string
The date of check out using the ISO 8601 format (YYYY-MM-DD)
Headers
Authorization
required
string
Authentication <api key>
Response
200: OK
{
"availability": [
{
"hotel_id": "9Q8YG862",
"room_id": "9Q8YG862",
"rate_plan_id": "J08ER564",
"currency": "EUR",
"price": 67
},
{
"hotel_id": "9Q8YG862",
"room_id": "9Q8YG862",
"rate_plan_id": "9Q8YG862",
"currency": "EUR",
"price": 87
},
{
"hotel_id": "9Q8YG862",
"room_id": "7VD318Z4",
"rate_plan_id": "7VD318Z4",
"currency": "EUR",
"price": 117
}
],
"hotel": {
"id": "9Q8YG862",
"name": "Athens Hotel",
"description": "Have a comfortable stay in a neighbourhood filled with cosy restaurants, bars and boutique shops, but also just steps away from Athens most popular sites and historical museums. \r\n\r\nEnjoy our lovingly prepared breakfast for a good start of your day full of sightseeing, shopping or just relaxing and enjoying the wonderful city of Athens.",
"address_line_1": "1 Street",
"address_line_2": "",
"postcode": "14521",
"city": "Athens",
"country": "Greece",
"currency": "",
"star_rating": 5,
"images": [
{
"tag": "Featured",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/3WGEQGLK/media/image-0-20201022T112324903321.jpg",
"width": 1678,
"height": 1233
}
],
"translations": [],
"facilities": []
},
"rate_plans": [
{
"id": "9Q8YG862",
"hotel_id": "9Q8YG862",
"name": "Flexible",
"description": "Stay fully flexible with free cancellation until midnight one day prior to arrival. Just put your CC on file to guarantee the booking.",
"services": [
{
"id": "9Q8YG862",
"name": "Breakfast",
"description": "Enjoy fresh fruit, just-baked viennoiseries, or a hearty morning meal.",
"price": 15,
"pricing_unit": "Person"
}
],
"cancellation_policy": {
"name": "Flexible",
"description": "Free cancellation until check-in",
"charge_type": "percentage",
"amount": 100
},
"no_show_policy": {
"name": "Non Refundable",
"description": "No free no-show",
"charge_type": "percentage",
"amount": 100
},
"translations": [
{
"locale": "el",
"name": "Ευέλικτο",
"description": "Ευέλικτο πλάνο που σας παρέχει δωρεάν ακύρωση έως μια μέρα πριν την άφιξη σας."
}
]
},
{
"id": "7VD318Z4",
"hotel_id": "9Q8YG862",
"name": "Flexible",
"description": "Stay fully flexible with free cancellation until midnight one day prior to arrival. Just put your CC on file to guarantee the booking.",
"services": [],
"cancellation_policy": {
"name": "Flexible",
"description": "Free cancellation until check-in",
"charge_type": "percentage",
"amount": 100
},
"no_show_policy": {
"name": "Non Refundable",
"description": "No free no-show",
"charge_type": "percentage",
"amount": 100
},
"translations": [
{
"locale": "el",
"name": "Ευέλικτο",
"description": "Ευέλικτο πλάνο που σας παρέχει δωρεάν ακύρωση έως μια μέρα πριν την άφιξη σας."
}
]
},
{
"id": "J08ER564",
"hotel_id": "9Q8YG862",
"name": "Non Refundable",
"description": "Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
"services": [],
"cancellation_policy": {
"name": "Non Refundable",
"description": "No free cancellation",
"charge_type": "percentage",
"amount": 100
},
"no_show_policy": {
"name": "Non Refundable",
"description": "No free no-show",
"charge_type": "percentage",
"amount": 100
},
"translations": []
}
],
"rooms": [
{
"id": "9Q8YG862",
"hotel_id": "9Q8YG862",
"name": "Single",
"description": "Nice and comfortable room with overlooking the Aegean sea",
"beds": [
{
"name": "Single Bed(s)",
"occupancy": 1,
"number_of_beds": 1
}
],
"images": [
{
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/3WGEQGLK/rooms/3WGEQGLK/image-0-20201020T102505533643.jpg",
"width": 960,
"height": 640
},
{
"tag": "Featured",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/3WGEQGLK/rooms/3WGEQGLK/image-1-20201021T083422400641.jpg",
"width": 1024,
"height": 683
},
],
"translations": [
{
"locale": "el",
"name": "Μονό Δωμάτιο",
"description": "Υπέροχο και άνετο δωμάτιο με θέα το αιγαίο πέλαγος."
}
],
"amenities": [
{
"category": "Room amenities",
"name": "Infinity pool "
},
{
"category": "Room amenities",
"name": "Fireplace"
},
{
"category": "Room amenities",
"name": "Heating"
},
{
"category": "Room amenities",
"name": "Iron"
},
{
"category": "Room amenities",
"name": "Safety deposit box"
},
{
"category": "Bathroom",
"name": "Private bathroom"
},
{
"category": "Food and drink",
"name": "Bottle of water"
},
{
"category": "Services and extras",
"name": "Wake-up service"
},
]
},
{
"id": "7VD318Z4",
"hotel_id": "9Q8YG862",
"name": "Double",
"description": "Big room with balcony, whirlpool and a kingsize bed.",
"beds": [
{
"name": "King Bed(s)",
"occupancy": 2,
"number_of_beds": 1
}
],
"images": [
{
"tag": "Featured",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/3WGEQGLK/rooms/QLY32G46/image-0-20201021T083608803153.jpg",
"width": 1024,
"height": 683
},
{
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/3WGEQGLK/rooms/QLY32G46/image-1-20201021T083609083516.jpg",
"width": 1024,
"height": 683
},
],
"translations": [
{
"locale": "el",
"name": "Διπλό δωμάτιο",
"description": "Μεγάλο διπλό δωμάτιο με μπαλκόνι και υπέρδιπλο κρεβάτι."
}
],
"amenities": [
{
"category": "Room amenities",
"name": "Iron"
},
{
"category": "Room amenities",
"name": "Hypoallergenic"
},
{
"category": "Room amenities",
"name": "Feather pillow"
},
{
"category": "Bathroom",
"name": "Bathrobe"
},
{
"category": "Services and extras",
"name": "Key card access"
},
{
"category": "Outdoor and view",
"name": "Garden view"
},
{
"category": "Accessibility",
"name": "Toilet with grab rails"
}
]
}
]
}

Rate plans

get
Rate Plan

https://[environment].katanox.com/v0/hotels/:hotel_id/rate-plans/:rate_plan_id
Get information about a specific rate plan
Request
Response
Request
Path Parameters
hotel_id
required
string
The id of the hotel
rate_plan_id
required
string
The id of the rate plan
Headers
Authorization
required
string
Bearer <api key>
Query Parameters
children
required
integer
The number of children
adults
required
integer
The number of adults
check_in
required
string
The date of check in using the ISO 8601 format (YYYY-MM-DD)
check_out
required
string
The date of check out using the ISO 8601 format (YYYY-MM-DD)
Response
200: OK
Cake successfully retrieved.
{
"availability": [
{
"hotel_id": "9Q8YG862",
"room_id": "9Q8YG862",
"rate_plan_id": "J08ER564",
"currency": "EUR",
"price": 67
}
],
"rate_plan": {
"id": "J08ER564",
"hotel_id": "9Q8YG862",
"name": "Non Refundable",
"description": "Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
"services": [],
"cancellation_policy": {
"name": "Non Refundable",
"description": "No free cancellation",
"charge_type": "percentage",
"amount": 100
},
"no_show_policy": {
"name": "Non Refundable",
"description": "No free no-show",
"charge_type": "percentage",
"amount": 100
},
"translations": []
}
}

Rooms

get
Room

https://[environment].katanox.com/v0/hotels/:hotel_id/rooms/:room_id
Get information about a specific room
Request
Response
Request
Path Parameters
room_id
required
string
The id of the room
Headers
Authorization
required
string
Bearer <api key>
Response
200: OK
{
"room": {
"id": "1O5DKN0Q",
"hotel_id": "EY53D76G",
"name": "Single",
"description": "Nice and comfortable room with shower and single bed. There is a spacious desk available in the room, your own coffee machine, and a comfortable sofa to enjoy the view or watch some tv from.",
"beds": [
{
"name": "Single Bed(s)",
"occupancy": 1,
"number_of_beds": 1
}
],
"images": [
{
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/OWYDOG7Q/image-0-20201021T193542202369.jpg",
"width": 1024,
"height": 683
},
{
"tag": "Featured",
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/OWYDOG7Q/image-1-20201021T193542509269.jpg",
"width": 1024,
"height": 683
},
{
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/OWYDOG7Q/image-2-20201021T193542731962.jpg",
"width": 799,
"height": 533
},
{
"url": "https://cdn.traveldata.io/katanox-inventory-sandbox/hotels/QLY32G46/rooms/OWYDOG7Q/image-3-20201021T193542844116.jpg",
"width": 800,
"height": 536
}
],
"translations": [],
"amenities": []
}
}