Perform an extras availability request

Table of Contents

1. URL Endpoint
2. Method Parameters
3. JSON Response Schema
4. JSON Response Example

URL Endpoint

/availability/{propertycode}/extras/{rateid}

Method Parameters

Basic parameters

NAME	TYPE	RANGE / SET	REQUIRED	DEFAULT	EXAMPLE	NOTES
checkin	date (ISO 8601)	from today to (today + 2 years)	YES	–	&checkin=<2020-07-09
checkout	date (ISO 8601)	from (checkin + 1) to (checkin + 30)	YES	checkin + 1 day	&checkout=2020-07-16	When used, number of nights is automatically calculated. Limitations apply (see nights).
adults	integer	1 – max capacity	NO	2	&adults=2	The value is PER ROOM. Maximum value is automatically calculated based on the property's maximum possible room capacity.
children	integer	0 – (max capacity-1)	NO	0	&children=1	The value is PER ROOM. Maximum value equals (maximum capacity - 1).
infants	integer	0 – (max capacity-1)	NO	0	&infants=1	The value is PER ROOM. Maximum value equals (maximum capacity - 1).
rooms	integer	1 – 5	NO	1	&rooms=2

Advanced parameters

NAME	TYPE	RANGE / SET	REQUIRED	DEFAULT	EXAMPLE	NOTES
remote_country	string	ISO 3166-1-alpha-2	NO†	–	&remote_country=US	Specifies remote user's country. Use ip address geolocation. Required for working with markets.
remote_ip	string	Dot-decimal notation	NO†	–	&remote_ip=94.71.170.105	Specifies remote user's ip address. Alternative to country. Required for working with markets. Only IPv4 supported.
bk_code	string	varchar(255)	NO	–	&bk_code=SPECIALRATES	Returns private rates that are enabled by specified booking code
voucher	string	varchar(255)	NO	–	&voucher=VCH123	Unlocks special offers

^† You can use remote_country or remote_ip. If you use both, remote_country takes precedence and remote_ip is ignored.

Method Output

This method returns a response with the following structure (inside data):

JSON Response Schema

...
	extras: [
		{
			"name":STRING,
			"description":STRING,
			"id":INTEGER,
			"extra_price":MONEY, // Price per unit
			"price":MONEY, // Total price for the stay
			"per_day":BOOLEAN, // Pricing per day
			"per_adult":BOOLEAN, // Pricing per adult
			"per_child":BOOLEAN, // Pricing per child
			"per_infant":BOOLEAN, // Pricing per infant
			"per_room":BOOLEAN, // Pricing per room
			"required":BOOLEAN, // 1=It is required and already calculated in the stay's price
			"max_quantity":INTEGER, // Cannot book more than this number
			"excl":Array, // An array of extras ids that this extra cannot be booked with
			"from":ISO 8601,
			"to":ISO 8601
		}
	]
...

JSON Response Example