Properties Collection

Property is a physical premises – hotels, motels, lodges, cabins, chalets, luxury apartments and other types of buildings. Usually each property has a unique address.
Don't combine multiple properties into one, it's better they are all created separately with their own address and details
Properties List
Retrieve list of properties associated with user.
Request
Success Response
Error Response
Request:
1
GET https://staging.channex.io/api/v1/properties
Copied!
Success Response Example
Status Code: 200 OK
1
{
2
  "data": [
3
    {
4
      "type": "property",
5
      "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
6
      "attributes": {
7
        "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
8
        "title": "Demo Hotel",
9
        "is_active": true,
10
        "email": "[email protected]",
11
        "phone": "01267237037",
12
        "currency": "GBP",
13
        "country": "GB",
14
        "state": "Demo State",
15
        "city": "Demo Town",
16
        "address": "Demo Street",
17
        "zip_code": "SA23 2JH",
18
        "latitude": null,
19
        "longitude": null,
20
        "timezone": "Europe/London",
21
        "property_type": "hotel",
22
        "content": {
23
          "description": "Some Property Description Text",
24
          "photos": [{
25
            "author": "Author Name",
26
            "description": "Room View",
27
            "id": "4355439c-df23-4f12-bffd-26476e31dd4a",
28
            "kind": "photo",
29
            "position": 0,
30
            "property_id": "716305c4-561a-4561-a187-7f5b8aeb5920",
31
            "room_type_id": null,
32
            "url": "https://img.channex.io/af08bc1d-8074-476c-bdb7-cec931edaf6a/"
33
          }],
34
          "important_information": null
35
        },
36
        "logo_url": null,
37
        "acc_channels_count": 0
38
      },
39
      "relationships": {
40
        "groups": {
41
          "data": [
42
            {
43
              "id": "f5338935-7fe0-40eb-9d7e-4dbf7ecc52c7",
44
              "type": "group",
45
              "attributes": {
46
                "id": "f5338935-7fe0-40eb-9d7e-4dbf7ecc52c7",
47
                "title": "User Group"
48
              }
49
            }
50
          ]
51
        },
52
        "facilities": {
53
            "data": []
54
        }
55
      }
56
    }
57
  ],
58
  "meta": {
59
    "limit": 10,
60
    "page": 1,
61
    "total": 1
62
  }
63
}
Copied!
Unauthorised Error Response
Status Code: 401 Unauthorized
1
{
2
  "errors": {
3
    "code": "unauthorized",
4
    "title": "Unauthorized"
5
  }
6
}
Copied!
Pagination and Filters
By default, this method return first 10 element. To get more details, you should use Pagination arguments.
Information about count of entities and current pagination position contained at meta section at response object.
This endpoint accept filters for fields: id, title, is_active.
Returns
Success
Method can return a Success result with 200 OK HTTP Code if operation is successful. Will contain a list of Property objects in the answer.

Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized HTTP Code if wrong Bearer Token provided. 
Property Options
Method to get list of all properties associated with current account without additional details and pagination limits.
Request
Success Response
Error Response
Request:
1
GET https://staging.channex.io/api/v1/properties/options
Copied!
Success Response Example
Status Code: 200 OK
1
{
2
  "data": [
3
    {
4
      "attributes": {
5
        "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
6
        "title": "Demo Hotel",
7
        "currency": "GBP"
8
      },
9
      "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
10
      "type": "properties"
11
    }
12
  ]
13
}
Copied!
Unauthorised Error Response
Status Code: 401 Unauthorized
1
{
2
  "errors": {
3
    "code": "unauthorized",
4
    "title": "Unauthorized"
5
  }
6
}
Copied!
Create Property
Create a new Property.
Request
Success Response
Error Response
Request:
1
POST https://staging.channex.io/api/v1/properties
Copied!
Query body (JSON):
1
{
2
  "property": {
3
    "title": "Demo Hotel",
4
    "currency": "GBP",
5
    "email": "[email protected]",
6
    "phone": "01267237037",
7
    "zip_code": "SA23 2JH",
8
    "country": "GB",
9
    "state": "Demo State",
10
    "city": "Demo Town",
11
    "address": "Demo Street",
12
    "longitude": "-0.2416781",
13
    "latitude": "51.5285582",
14
    "timezone": "Europe/London",
15
    "facilities": [],
16
    "property_type": "hotel",
17
    "group_id": "f5338935-7fe0-40eb-9d7e-4dbf7ecc52c7",
18
    "settings": {
19
      "allow_availability_autoupdate": true,
20
      "min_price": null,
21
      "max_price": null,
22
      "state_length": 500
23
    }
24
    "content": {
25
      "description": "Some Property Description Text",
26
      "photos": [{
27
        "url": "https://img.channex.io/af08bc1d-8074-476c-bdb7-cec931edaf6a/",
28
        "position": 0,
29
        "author": "Author Name",
30
        "kind": "photo",
31
        "description": "Room View"
32
      }],
33
      "important_information": "Some important notes about property"
34
    },
35
    "logo_url": "https://hotel.domain/logo.png"
36
  }
37
}
Copied!
Success Response Example
Status Code: 201 Created
1
{
2
  "data": {
3
    "type": "property",
4
    "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
5
    "attributes": {
6
      "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
7
      "title": "Demo Hotel",
8
      "is_active": true,
9
      "email": "[email protected]",
10
      "phone": "01267237037",
11
      "currency": "GBP",
12
      "country": "GB",
13
      "state": "Demo State",
14
      "city": "Demo Town",
15
      "address": "Demo Street",
16
      "zip_code": "SA23 2JH",
17
      "longitude": "-0.2416781",
18
      "latitude": "51.5285582",
19
      "timezone": "Europe/London",
20
      "property_type": "hotel",
21
      "content": {
22
        "description": "Some Property Description Text",
23
        "photos": [{
24
          "author": "Author Name",
25
          "description": "Room View",
26
          "id": "4355439c-df23-4f12-bffd-26476e31dd4a",
27
          "kind": "photo",
28
          "position": 0,
29
          "property_id": "716305c4-561a-4561-a187-7f5b8aeb5920",
30
          "room_type_id": null,
31
          "url": "https://img.channex.io/af08bc1d-8074-476c-bdb7-cec931edaf6a/"
32
        }],
33
        "important_information": null
34
      },
35
      "logo_url": null,
36
      "acc_channels_count": 0,
37
      "settings": {
38
        "allow_availability_autoupdate": false,
39
        "max_price": null,
40
        "min_price": null
41
      }
42
    },
43
    "relationships": {
44
      "groups": {
45
        "data": [
46
          {
47
            "id": "f5338935-7fe0-40eb-9d7e-4dbf7ecc52c7",
48
            "type": "group",
49
            "attributes": {
50
              "id": "f5338935-7fe0-40eb-9d7e-4dbf7ecc52c7",
51
              "title": "User Group"
52
            }
53
          }
54
        ]
55
      },
56
      "facilities": {
57
          "data": []
58
      }
59
    }
60
  }
61
}
Copied!
Unauthorised Error Response
Status Code: 401 Unauthorized
1
{
2
  "errors": {
3
    "code": "unauthorized",
4
    "title": "Unauthorized"
5
  }
6
}
Copied!
Validation Error Response
Status Code: 422 Unprocessable Entity
1
{
2
  "errors": {
3
    "code": "validation_error",
4
    "title": "Validation Error",
5
    "details": {
6
      "title": [
7
        "can't be blank"
8
      ]
9
    }
10
  }
11
}
Copied!
Fields
title [required]
Any non-empty string with maximum length of 255 symbols.
Note: The property will be represented in the system under that title.
currency [required]
3 symbols long string with Currency Alphabetic code based at ISO 4217.
Note: This currency will be used as default currency for nested Property entities and provided as default property currency to 3rd party services.
email [optional]
String with a valid email address.
Note: This email address will be provided to 3rd party services as contact email address for that property.
Field is optional at initial setup step, but required when you try connect first 3rd party service.
phone [optional]
String with maximum length of 32 symbols. Can contain digits, spaces, brackets and special characters.
Note: This phone will be provided to 3rd party services as contact email address for that property.
Field is optional at initial setup step, but required when you try connect first 3rd party service.
zip_code [optional]
String with maximum length of 32 symbols.
Note: This zip_code will be provided to 3rd party services as part of contact address for that property.
Field is optional at initial setup step, but required when you try connect first 3rd party service.
country [optional]
2 symbols long string with Country Alpha-2 code based at ISO-3166-1.
Note: This country will be provided to 3rd party services as part of contact address for that property.
Field is optional at initial setup step, but required when you try connect first 3rd party service.
state [optional]
String with maximum length of 255 symbols.
Note: This state will be provided to 3rd party services as part of contact address for that property.
Field is optional at initial setup step, but required when you try connect first 3rd party service.
city [optional]
String with maximum length of 255 symbols.
Note: This city will be provided to 3rd party services as part of contact address for that property.
Field is optional at initial setup step, but required when you try connect first 3rd party service.
address [optional]
String with maximum length of 255 symbols.
Note: This address will be provided to 3rd party services as part of contact address for that property.
Field is optional at initial setup step, but required when you try connect first 3rd party service.
longitude [optional]
Decimal number represented as String with maximum length of 10 symbols. Can have maximum 7 decimal chars.
Minimum value: -180.
Maximum value: +180.
Note: This field is part of property coordinates.
Field is optional at initial setup step, but required when you try connect first 3rd party service.
latitude [optional]
Decimal number represented as String with maximum length of 9 symbols. Can have maximum 7 decimal chars.
Minimum value: -90.
Maximum value: +90.
Note: This field is part of property coordinates.
Field is optional at initial setup step, but required when you try connect first 3rd party service.
timezone [optional]
Timezone name from ISO 8601. All possible values you can find at Time zone database (https://www.iana.org/time-zones). More info about Time Zone database is here - https://en.wikipedia.org/wiki/Tz_database.
facilities [optional]
List of Property Facility IDs associated with Property.
property_type [optional]
One of possible values:
apart_hotel
apartment
boat
camping
capsule_hotel
chalet
country_house
farm_stay
guest_house
holiday_home
holiday_park
homestay
hostel
hotel
inn
lodge
motel
resort
riad
ryokan
tent
villa
group_id [optional]
String with valid UUID for Group object what you would like to use as Base Group for created Property.
Field is optional, if it is not provided, system automatically assign Default User Group as Base Group for Property.
settings [optional]
Object with Property settings. Should contain next fields:
allow_availability_autoupdate - option to allow increase and decrease Availability when bookings is came into Channex.
min_price - setup minimum price per property. When user try to setup price less then min_price, system increase it up to minimum.
max_price - setup maximum price per property. When user try to setup price greater then max_price, system decrease it up to maximum.
state_length - setup length of inventory table for Property. Min value is 100 days, max value is 730 days.
content [optional]
Object with content information for property. Content object can contain:
description - optional text field with Property description. By default Description will be equal to null.
important_information - optional text field with some important information about Property. Will be included into Booking confirmation emails.
photos - optional list of photos associated with Property. Each photo is object with next fields:
url - photo URL
position - integer value to represent photo position at list, Photo with position equal to 0 is used as Cover Photo for property
description - Photo text description
author - Name of photo Author
kind - one of three possible values: photo, ad (advertising), menu (restaurant menu photo).
More information about Photo API is here.
logo_url [optional]
String. Valid URL to property logo. Logo will be copied into our media storage.
Read only fields
acc_cannels_count
Integer. Count of connected channels. Aggregate.
Returns
Success
Method can return a Success result with 201 Created HTTP Code if operation is successful. Will contain a Property object in the answer.

Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized HTTP Code if wrong Bearer Token provided.
Validation Error
Method can return a Validation Error result with 422 Unprocessable Entity HTTP Code if any validation rule is failed.
Get Property by ID
Retrieve specific property associated with User by ID.
Request
Success Response
Error Response
Request:
1
GET https://staging.channex.io/api/v1/properties/:id
Copied!
Success Response Example
Status Code: 200 OK
1
{
2
  "data": {
3
    "type": "property",
4
    "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
5
    "attributes": {
6
      "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
7
      "title": "Demo Hotel",
8
      "is_active": true,
9
      "email": "[email protected]",
10
      "phone": "01267237037",
11
      "currency": "GBP",
12
      "country": "GB",
13
      "state": "Demo State",
14
      "city": "Demo Town",
15
      "address": "Demo Street",
16
      "zip_code": "SA23 2JH",
17
      "latitude": null,
18
      "longitude": null,
19
      "timezone": "Europe/London",
20
      "property_type": "hotel",
21
      "content": {
22
        "description": "Some Property Description Text",
23
        "photos": [{
24
          "author": "Author Name",
25
          "description": "Room View",
26
          "id": "4355439c-df23-4f12-bffd-26476e31dd4a",
27
          "kind": "photo",
28
          "position": 0,
29
          "property_id": "716305c4-561a-4561-a187-7f5b8aeb5920",
30
          "room_type_id": null,
31
          "url": "https://img.channex.io/af08bc1d-8074-476c-bdb7-cec931edaf6a/"
32
        }],
33
        "important_information": null
34
      },
35
      "settings": {
36
        "allow_availability_autoupdate": true,
37
        "max_price": null,
38
        "min_price": null
39
      },
40
      "logo_url": null,
41
      "acc_channels_count": 0
42
    },
43
    "relationships": {
44
      "groups": {
45
        "data": [
46
          {
47
            "id": "f5338935-7fe0-40eb-9d7e-4dbf7ecc52c7",
48
            "type": "group",
49
            "attributes": {
50
              "id": "f5338935-7fe0-40eb-9d7e-4dbf7ecc52c7",
51
              "title": "User Group"
52
            }
53
          }
54
        ]
55
      },
56
      "facilities": {
57
          "data": []
58
      }
59
    }
60
  }
61
}
Copied!
Unauthorised Error Response
Status Code: 401 Unauthorized
1
{
2
  "errors": {
3
    "code": "unauthorized",
4
    "title": "Unauthorized"
5
  }
6
}
Copied!
Returns
Success
Method can return a Success result with 200 OK HTTP Code if operation is successful. Will contain a Property object in the answer.

Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized HTTP Code if wrong Bearer Token provided or User not have access to requested Property.
Update Property
Update property information.
Request
Success Response
Error Response
Request:
1
PUT https://staging.channex.io/api/v1/properties/:id
Copied!
Query body (JSON):
1
{
2
  "property": {
3
    "title": "Demo Hotel",
4
    "currency": "GBP",
5
    "email": "[email protected]",
6
    "phone": "01267237037",
7
    "zip_code": "SA23 2JH",
8
    "country": "GB",
9
    "state": "Demo State",
10
    "city": "Demo Town",
11
    "address": "Demo Street"
12
    "longitude": "-0.2416781",
13
    "latitude": "51.5285582",
14
    "timezone": "Europe/London",
15
    "facilities": [],
16
    "property_type": "hotel",
17
    "content": {
18
      "description": "Some Property Description Text",
19
      "photos": [{
20
	      "url": "https://img.channex.io/af08bc1d-8074-476c-bdb7-cec931edaf6a/",
21
    	  "position": 0,
22
        "author": "Author Name",
23
        "kind": "photo",
24
        "description": "Room View"
25
      }]
26
    }
27
  }
28
}
Copied!
Success Response Example
Status Code: 200 OK
1
{
2
  "data": {
3
    "type": "property",
4
    "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
5
    "attributes": {
6
      "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
7
      "title": "Demo Hotel",
8
      "is_active": true,
9
      "email": "[email protected]",
10
      "phone": "01267237037",
11
      "currency": "GBP",
12
      "country": "GB",
13
      "state": "Demo State",
14
      "city": "Demo Town",
15
      "address": "Demo Street",
16
      "zip_code": "SA23 2JH",
17
      "latitude": null,
18
      "longitude": null,
19
      "timezone": "Europe/London",
20
      "property_type": "hotel",
21
      "content": {
22
        "description": "Some Property Description Text",
23
        "photos": [{
24
          "author": "Author Name",
25
          "description": "Room View",
26
          "id": "4355439c-df23-4f12-bffd-26476e31dd4a",
27
          "kind": "photo",
28
          "position": 0,
29
          "property_id": "716305c4-561a-4561-a187-7f5b8aeb5920",
30
          "room_type_id": null,
31
          "url": "https://img.channex.io/af08bc1d-8074-476c-bdb7-cec931edaf6a/"
32
        }],
33
        "important_information": null
34
      },
35
      "settings": {
36
        "allow_availability_autoupdate": true,
37
        "max_price": null,
38
        "min_price": null
39
      },
40
      "logo_url": null,
41
      "acc_channels_count": 0
42
    },
43
    "relationships": {
44
      "groups": {
45
        "data": [
46
          {
47
            "id": "f5338935-7fe0-40eb-9d7e-4dbf7ecc52c7",
48
            "type": "group",
49
            "attributes": {
50
              "id": "f5338935-7fe0-40eb-9d7e-4dbf7ecc52c7",
51
              "title": "User Group"
52
            }
53
          }
54
        ]
55
      },
56
      "facilities": {
57
          "data": []
58
      }
59
    }
60
  }
61
}
Copied!
Unauthorised Error Response
Status Code: 401 Unauthorized
1
{
2
  "errors": {
3
    "code": "unauthorized",
4
    "title": "Unauthorized"
5
  }
6
}
Copied!
Validation Error Response
Status Code: 422 Unprocessable Entity
1
{
2
  "errors": {
3
    "code": "validation_error",
4
    "title": "Validation Error",
5
    "details": {
6
      "title": [
7
        "can't be blank"
8
      ]
9
    }
10
  }
11
}
Copied!
Fields
This method uses the same fields as Create Property method.
Returns
Success
Method can return a Success result with 200 OK HTTP Code if operation is successful. Will contain a Property object in the answer.

Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized HTTP Code if wrong Bearer Token provided or User not have access to requested Property.
Validation Error
Method can return a Validation Error result with 422 Unprocessable Entity HTTP Code if any validation rule is failed.