Rate Listing - API

The rate listing method return a list of active rates for a specific property. The results can be filtered based on name or date. You can also supply a booking code to unlock private rates.

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

URL Endpoint

You can request all rates of a property or all rates of a specific room type in a property.

/rate/{propertycode}
/rate/{propertycode}/{roomcode}

Room Codes

You can use the property API to retrieve room type codes.

Method Parameters

NAME TYPE RANGE / SET REQUIRED DEFAULT EXAMPLE NOTES
name string varchar(255) NO – &name=Best%20Available name of rate
fromd date (ISO 8601) NO today &fromd=2026-01-01 overlapped rates will be returned
(ending after fromd, so rates that ended before today are not returned unless an earlier fromd is sent)
tod date (ISO 8601) NO – &tod=2026-12-31 overlapped rates will be returned
(starting before tod)
bk_code string varchar(255) NO† – &bk_code=SPECIALRATES returns private rates that are enabled by specified booking code
public boolean NO ALL for PMS, 1 of other accounts &public=0 only available to Hotelier API accounts
active boolean NO ALL for PMS, 1 of other accounts &active=0 only available to Hotelier API accounts
verbose integer 0
1
2		 NO 0 &verbose=1 0: Basic info
1: Full info
2: Full info + policies

Account Types

For Travel Agent accounts, rates returned are restricted to Retail/B2B and B2B-only rates. For Corporate accounts, rates returned are restricted to corporate rates.

No Matching Rates

When the property has no rates matching the request filters, the response has HTTP code 200 with error_code NO_RATES_FOUND and no rates array. For Travel Agent and Corporate accounts, when none of the matching rates is available to the account, the response has error_code OK and an empty rates array.

JSON Response Schema

{
	"method": "https://rest.reserve-online.net/rate/DEMO"
	"http_method": "GET",
	"http_code": 200,
	"error_code": "OK",
	"error_msg": "",
	"params": [],
	"data":{
		"rates":[
			{
				"id":INTEGER, // Rate id
				"room":STRING, // Rate room code (each rate belongs to only one room)
				"name":STRING, // Rate name
				"board":INTEGER, // Board ID: see Data Types
				"active":BOOLEAN, // Indicates if rate is active
				"public":BOOLEAN, // Indicates if rate is public or private
				"parent":INTEGER, // Parent rate id. If this value is > 0, it means this rate is a child rate.
				"virtual":BOOLEAN, // Indicates if rate is virtual (imported from 3rd-party systems e.g Channel Manager)
				"currency":ISO 4217, // Rate currency ISO code
				"url":URL, // API URL for rate info request
				"roomurl":URL, // API URL for room info request
				"roomName":STRING, // Rate room name (only in verbose=1 mode)
				"fromd":ISO 8601, // Rate start date (only in verbose=1 mode)
				"tod":ISO 8601, // Rate end date (only in verbose=1 mode)
				"description":STRING, // Rate short description (only in verbose=1 mode)
				"presentation":STRING, // Rate full html presentation (only in verbose=2 mode)
				"constraints": { (only in verbose=1 mode)
					"expiration":ISO 8601, // Rate expiry date (optional)
					"freeCancelDays":INTEGER, // Days before checkin this rate can be cancelled without cancellation fees
					"earlyBookLimit":INTEGER // Days before checkin this rate can be booked
				},
				(only in verbose=2 mode)
				"policies": {
					"cancellation":STRING, // Cancellation policy text
					"payment":STRING // Payment policy text
				}
			}
		]
	}
}

JSON Response Example

{
	"method": "http://rest.reserve-online.net/rate/DEMO",
	"http_method": "GET",
	"http_code": 200,
	"error_code": "OK",
	"error_msg": "",
	"params": [],
	"data": {
		"rates": [
			{
				"id": 21830,
				"room": "JSUI",
				"name": "Standard Rate",
				"board": 0,
				"active": 1,
				"public": 1,
				"parent": 0,
				"virtual": 0,
				"currency": "EUR",
				"url": "http://rest.reserve-online.net/rate/demo/JSUI/21830",
				"roomurl": "http://rest.reserve-online.net/property/demo/JSUI"
			},
			{
				"id": 28153,
				"room": "FML",
				"name": "Fully Flexible Rate",
				"board": 4,
				"active": 1,
				"public": 1,
				"parent": 0,
				"virtual": 0,
				"currency": "EUR",
				"url": "http://rest.reserve-online.net/rate/demo/FML/28153",
				"roomurl": "http://rest.reserve-online.net/property/demo/FML"
			},
			{
				"id": 181503,
				"room": "FML",
				"name": "Make your offer",
				"board": 4,
				"active": 1,
				"public": 1,
				"parent": 179983,
				"virtual": 0,
				"currency": "EUR",
				"url": "http://rest.reserve-online.net/rate/demo/FML/181503",
				"roomurl": "http://rest.reserve-online.net/property/demo/FML"
			},
			{
				"id": 75222,
				"room": "FML",
				"name": "Special Prepaid Rate",
				"board": 4,
				"active": 1,
				"public": 1,
				"parent": 0,
				"virtual": 0,
				"currency": "EUR",
				"url": "http://rest.reserve-online.net/rate/demo/FML/75222",
				"roomurl": "http://rest.reserve-online.net/property/demo/FML"
			},
			{
				"id": 116052,
				"room": "REG",
				"name": "Standard rate",
				"board": 0,
				"active": 1,
				"public": 1,
				"parent": 0,
				"virtual": 0,
				"currency": "EUR",
				"url": "http://rest.reserve-online.net/rate/demo/REG/116052",
				"roomurl": "http://rest.reserve-online.net/property/demo/REG"
			}
		],
		"summary": {
			"records": 5
		}
	}
}

In the example below, the request was submitted with verbose=1



  
In the example below, the request was submitted with verbose=2