Properties

Two methods are available for displaying properties assigned to a publisher. One for viewing property details and another for retrieving availability.

Endpoint	HTTP
/publisher/v3.0/properties/view/.json	POST
/publisher/v3.0/properties/available/.json	POST

View

HTTP POST: /publisher/v3.0/properties/view/.json

Returns property data without availability. Take care to use a verbosity level that makes sense. When verbosity is increased, requests take longer.

View Definitions:

Attribute	Type	Required	Default	Definition
key	string	yes		Your API key
limit	int	no	0	Limits the number of results returned. 0 will return all
verbosity	int	no	0	Controls the amount of data returned. 0 (least) - 3 (most) are supported.

View Request:

{
   "key": "MyApiKey",
   "limit": 1,
   "verbosity": 3,
   "meta_data":{
      "session_id":"39s0m0gt4ubo4d7lsr2b1a1pq5",
      "user_agent":"Mozilla\/5.0 (X11; Linux x86_64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/68.0.3440.106 Safari\/537.36",
      "ip":"127.0.0.1"
   }
}

View property response.

Availability

HTTP POST: /publisher/v3.0/properties/available/.json

Returns property data with the addition of availability. Take care to use a verbosity level that makes sense. When verbosity is increased, requests take longer.

Availability Attributes:

Attribute	Type	Required	Default	Definition
key	string	yes		Your API key
properties	string	yes		Comma separated list of property IDs
checkin	string	yes		YYYY-MM-DD
checkout	string	yes		YYYY-MM-DD
rooms	array	yes		An array of room objects. See room definition below
promotion	string	no	all	Whether to require a promotion, accepts ‘required’ or ‘all’. If set to ‘required’ properties without promotions will not be returned
discount_code	string	no		Discount code
currency	string	no		Three letter ISO currency code. If not supplied will default to setting in the CRS Admin
limit	int	no	0	Limits the number of results returned. 0 will return all
verbosity	int	no	0	Controls the amount of data returned. 0 (least) - 3 (most) are supported.

Room Object

Specify a room object for each room the customer is looking to book. Note, some properties cannot support multi-room bookings.

Attribute	Type	Required	Default	Definition
adults	int	yes		Amount of adults
children	int	no	0	Amount of children

Availability Request:

{
   "key": "MyApiKey",
   "properties":"3144",
   "verbosity": 2,
   "currency":"USD",
   "checkin":"2019-02-17",
   "checkout":"2019-02-19",
   "discount_code":"",
   "promotion":"all",
   "rooms":[
      {
         "adults":2,
         "children":0
      }
   ],
   
   "meta_data":{
      "session_id":"39s0m0gt4ubo4d7lsr2b1a1pq5",
      "user_agent":"Mozilla\/5.0 (X11; Linux x86_64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/68.0.3440.106 Safari\/537.36",
      "ip":"127.0.0.1"
   }
}

Availability Response:

The response structure is an array of property objects, see property response.

Definitions

See Property Detail for definitions