Method to externally manage rate pricing

Table of Contents
  1. URL Endpoint
  2. Method Parameters
  3. Method Output

URL Endpoints

/manage/rates
/manage/rates/{rateid}

Warning

This method is only accessible using a Hotelier API account.

This method is only accessible using a GET request.

Terms

This method should be called only for user-initiated actions.

Scheduled ( automated ) calls on this method are only allowed if they happen a few times per day.

This method is NOT a replacement of channel-management functionality.

This method should NOT be used to feed 3rd party systems without our consent.

API usage is closely monitored and improper usage will result in a ban.


Method parameters

NAME TYPE RANGE / SET REQUIRED DEFAULT EXAMPLE NOTES
from date (ISO 8601) * YES &from=2017-07-21  
to date (ISO 8601) * YES &to=2018-07-21  

Method Output

All Rates

The feed for all rates has the following structure:

{
"RATECODE": [
		{
			"from":ISO 8601, // Start of date range, mutually exclusive with "date"
			"to":ISO 8601, // End of date range, mutually exclusive with "date"
			"date":ISO 8601, // Single-date record, mutually exclusive with "from" and "to"
			"pricing":
			[
				{
					"adults":INTEGER
					"children":INTEGER
					"price":NUMBER
				}
			],
			"closeout": 1, // 1=Rate is closed, missing means rate is open
			"min_stay": 4 // >1=Minimum stay enforced, missing means there is no minimum stay ( 1 )
		}
	]
}

Single Rate

The feed for a specific rate has the following structure:

[
	{
		"from":ISO 8601, // Start of date range, mutually exclusive with "date"
		"to":ISO 8601, // End of date range, mutually exclusive with "date"
		"date":ISO 8601, // Single-date record, mutually exclusive with "from" and "to"
		"pricing":
		[
			{
				"adults":INTEGER
				"children":INTEGER
				"price":NUMBER
			}
		],
		"closeout": 1, // Single-date record, mutually exclusive with "from" and "to"
		"min_stay": 4 // Single-date record, mutually exclusive with "from" and "to"
	}
]