Reservations

Reservations

post
Create Reservation

https://[host]/v0/reservations
When creating a Reservation in production, you will need to use the following endpoint instead, which proxies the credit card details via DataTrans' PCI-Proxy service.This way PCI compliance is achieved: https://api.pci-proxy.com/v1/push/f6ada3ff27a82d38/. If you are using the Sandbox environment, you need to send the requests directly to the katanox host using test credit cards.The rest of the requests can normally be issued using the normal katanox host.
Request
Response
Request
Headers
Authorization
required
string
Bearer <api key>
Response
200: OK
{
"reservation_id": "RZ86JDVK",
"vendor_reservation_id": "NZKKKVCP"
}
{
"hotel_id": "P2GL08WQ",
"total_price": {
"amount": 218,
"currency": "EUR"
},
"customer": {
"address_line_1": "123 Street",
"address_line_2": "",
"city": "City",
"country": "GB",
"email": "[email protected]",
"first_name": "Jorge",
"last_name": "Doe",
"phone": "",
"postcode": "DE22",
"title": "MR",
"birth_date": "1950-01-04"
},
"items": [
{
"comments" : ["We would like a wake up call every morning at 6am"],
"guests": [
{
"first_name": "John",
"last_name": "Doe",
"title": "MR"
}
],
"check_in": "2020-10-09",
"check_out": "2020-10-12",
"price": {
"amount": 218,
"currency": "EUR"
},
"rate_plan_id": "ZN8MQ5G1",
"room_id": "M7D2OGX9",
"adults": 1,
"children": 0,
"infants": 0
}
],
"comments": ["We will arrive around 8pm"],
"payment": {
"type": "visa",
"details": {
"card_number": "1234123412341234",
"cvv": "123",
"card_holder": "John Doe",
"expiry_month": "08",
"expiry_year": "2021"
}
}
}

get
Get Reservation

https://[environment].katanox.com/v0/reservations/:id
Request
Response
Request
Path Parameters
id
required
string
The ID of the reservation
Headers
Authorization
required
string
Bearer <api key>
Response
200: OK
{
"id": "RZ86JDVK",
"hotel_id": "P2GL08WQ",
"total_price": {
"amount": 218,
"currency": ""
},
"customer": {
"first_name": "Jorge",
"last_name": "Doe",
"title": "MR",
"address_line_1": "123 Street",
"postcode": "DE22",
"city": "City",
"country": "GB",
"email": "[email protected]",
"birth_date": "0001-01-01T00:00:00Z"
},
"items": [
{
"id": "1681780Y",
"comments": null,
"guests": [
{
"first_name": "Jorge",
"last_name": "Doe",
"title": "MR",
"address_line_1": "123 Street",
"postcode": "DE22",
"city": "City",
"country": "GB",
"email": "[email protected]",
"birth_date": "1950-01-04"
},
{
"first_name": "John",
"last_name": "Doe",
"title": "MR",
"birth_date": "0001-01-01"
}
],
"check_in": "2020-10-09",
"check_out": "2020-10-12",
"price": {
"amount": 218,
"currency": "EUR"
},
"rate_plan_id": "ZN8MQ5G1",
"room_id": "M7D2OGX9",
"adults": 1,
"children": 0,
"infants": 0
}
],
"comments": null,
"payment": {}
}

delete
Cancel Reservation

https://[environment].katanox.com/v0/reservations/:reservation_id
Request
Response
Request
Path Parameters
reservation_id
required
string
The ID of the reservation
Response
204: No Content

Reservation Items

post
Add Reservation Item

https://[environment].katanox.com/v0/reservations/:reservation_id/reservation-items
Request
Response
Request
Path Parameters
reservation_id
required
string
The ID of the reservation
Response
200: OK
{
"reservation_item_id": "XJ86WTWK",
"vendor_reservation_item_id": "FEWRGB42"
}
{
"comments": [
"We would like a wake up call every morning at 6am"
],
"guests": [
{
"first_name": "John",
"last_name": "Doe",
"title": "MR"
}
],
"check_in": "2020-10-10",
"check_out": "2020-10-15",
"price": {
"amount": 218,
"currency": "EUR"
},
"rate_plan_id": "ZN8MQ5G1",
"room_id": "M7D2OGX9",
"adults": 2,
"children": 1,
"infants": 0

put
Update Primary Guest

https://[environment].katanox.com/v0/reservations/:reservation_id/reservation-items/:reservation_item_id/primary-guest
Request
Response
Request
Path Parameters
reservation_id
required
string
The ID of the reservation
reservation_item_id
required
string
The ID of the reservation item
Headers
Authorization
required
string
Bearer <api key>
Response
204: No Content
{
"address_line_1": "123 Street",
"address_line_2": "",
"city": "City",
"country": "GB",
"email": "[email protected]",
"first_name": "Jorge",
"last_name": "Garcia",
"phone": "07848337754",
"postcode": "11193",
"title": "MR",
"birth_date": "1950-01-04"
}

put
Update Travel Dates

https://[environment].katanox.com/v0/reservations/:reservation_id/reservation-items/:reservation_item_id/travel-dates
Request
Response
Request
Path Parameters
reservation_id
required
string
The ID of the reservation
reservation_item_id
required
string
The ID of the reservation item
Response
204: No Content

{
"check_in": "2020-09-19",
"check_out": "2020-09-23",
"rate_plan_id": "ZN8MQ5G1"
}

put
Add guest

https://[environment].katanox.com/v0/reservations/:reservation_id/reservation-items/:reservation_item_id/additional-guests
Request
Response
Request
Path Parameters
reservation_id
required
string
The ID of the reservation
reservation_item_id
required
string
The ID of the reservation item
Headers
Authorization
required
string
Bearer <api key>
Response
204: No Content
{
"address_line_1": "123 Street",
"address_line_2": "",
"city": "City",
"country": "GB",
"email": "[email protected]",
"first_name": "Anna",
"last_name": "Cruz",
"phone": "06948228495",
"postcode": "43250",
"title": "Ms",
"birth_date": "1980-01-04"
}

delete
Cancel Reservation Item

https://[environment].katanox.com/v0/reservations/:reservation_id/reservation-items/:reservation_item_id
Request
Response
Request
Path Parameters
reservation_id
required
string
The ID of the reservation
reservation_item_id
required
string
The ID of the reservation item
Response
204: No Content