Properties

Definition

A property is short for Accommodation Property a term that is used to refer to any of the following types of accomodations:

  • Hotel
  • Apartments
  • Studios
  • Pensions
  • Villas
  • Hostel
  • Holiday Rentals
  • Guest Houses
  • B&Bs
  • Resorts
  • Serviced Apartments
  • Homestays
  • Boats
  • Boutique Hotels
  • Golf Hotels
  • Country Houses
  • Cabins
  • Inns
  • Eco Hotels
  • Motels
  • Condo Hotels
  • Holiday Cottage
  • Botels
  • Bed and breakfast
  • Chalet
  • Lodge
  • Aparthotel
  • Residence
  • Agritourism
  • Farm Stay
  • Bungalow
  • Holiday Homes

The list of definition is based on the definitions of https://opentravel.org/ and extended properties from Booking.com

Retrieve Property List (getProperties)

This method is used to obtain properties. Properties are returned based on the access right of the authenticated user.

Make sure to add the Authorization header as defined in the Authorization

GET ${domain}/property

The result of the request above will be a list of properties that the user has access to.

Retrieve a single property

You can retrieve at any given moment a property by passing the property id behind the property.

GET ${domain}/property/1

The result is a full Property Information

{
"id": 1,
"name": "Name Hotel",
"country": "Shqip�ri",
"stars": 3,
"hotelLogo": "logo-name.png",
"numberOfRooms": 20,
"status": {
"status": "active"
},
"hotelType": [
{
"type": "Apartments"
},
{
"type": "Hotel"
}
],
"hotelAttribute": [
{
"name": "Bathrooms"
},
{
"name": "Beds"
}
],
"hotelText": [],
"hotelPhoto": [
{
"id": 207,
"fileName": "DSCN8890.JPG"
},
{
"id": 205,
"fileName": "DSCN0214.JPG"
},
{
"id": 212,
"fileName": "GPTempDownload (15).jpeg"
},
{
"id": 209,
"fileName": "GPTempDownload (6).jpeg"
},
{
"id": 215,
"fileName": "GPTempDownload.jpeg"
},
{
"id": 213,
"fileName": "GPTempDownload (22).jpeg"
},
{
"id": 447,
"fileName": "Studio Apartment, Sea View.jpg"
},
{
"id": 216,
"fileName": "IMG_9067.jpeg"
},
{
"id": 206,
"fileName": "DSCN8887.JPG"
},
{
"id": 214,
"fileName": "GPTempDownload (20).jpeg"
},
{
"id": 211,
"fileName": "GPTempDownload (14).jpeg"
},
{
"id": 210,
"fileName": "GPTempDownload (9).jpeg"
}
],
"money": {
"currency": "EUR"
},
"language": [
{
"code": "sq",
"name": "Shqip"
},
{
"code": "en",
"name": "English"
}
],
"hotelTime": {
"timeZone": {
"id": 474,
"name": "(GMT+1:00) Europe/Tirane"
},
"checkOut": "10:00",
"checkIn": "12:00"
},
"address": {
"id": 1,
"region": "Vlor� County",
"telephone": "+355 ****",
"city": "Ksamil",
"onMap": "39.***, 20.***",
"street": "Rruga Eqerem Cabej",
"zipCode": "9706",
"email": "***@gmail.com",
"website": "www.hotel-***.al"
},
"hotelExternalSystem": [
{
"code": "***",
"name": "Tripadvisor",
"alterantiveCode": "111111"
}
],
"checkedOut": true,
"preferredLanguage": {
"code": "sq",
"name": "Shqip"
},
"hotelFacility": [
{
"name": "Beach"
},
{
"name": "Air-Conditioning / heating & underfloor Heating"
},
{
"name": "Bar"
},
{
"name": "Extra bed"
},
{
"name": "Table tennis"
},
{
"name": "Private Check-in/Check-out"
}
]
}

In case the request is coming from an unauthenticated user, then the response will be an empty body 401 http status with the header WWW-Authenticate: Bearer error="invalid_token"

Attemptint to access a property that you have no access on, will still return a 401 http error, but we make it explicit by passing a message indicating the error as well:

The response in such case looks like:

{
"message": "Access Denied",
"error": 401
}

If you believe there is an error, it surely is a human error, therefore please contact our team.

Retrieve Property Rooms

Te retrieve all the rooms of a property, you should make a get call at the following endpoint:

${DOMAIN}/property/rooms
{
"pid":9
}