Method to externally manage rate pricing
/manage/rates
/manage/rates/{rateid}
This method is only accessible using a Hotelier API account.
This method is only accessible using a GET request.
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.
| NAME | TYPE | RANGE / SET | REQUIRED | DEFAULT | EXAMPLE | NOTES |
|---|---|---|---|---|---|---|
| from | date (ISO 8601) | * | YES | – | &from=2024-09-20 | |
| to | date (ISO 8601) | today + 3 years | YES | – | &to=2025-09-20 | |
| rooms | string | varchar(4000) | NO | – | &rooms=DBL,SUITE,FAM | Comma separated list of room codes. Ignored if {rateid} is not specified. |
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":MONEY
}
],
"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)
}
]
}
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":MONEY
}
],
"closeout": 1, // Single-date record, mutually exclusive with "from" and "to"
"min_stay": 4 // Single-date record, mutually exclusive with "from" and "to"
}
]
Response example for All Rates request.
{
"254903": [
{
"from": "2024-03-20",
"to": "2024-03-30",
"min_stay": 2,
"pricing": [
{
"adults": 1,
"children": 0,
"price": 200
},
{
"adults": 2,
"children": 0,
"price": 250
}
]
}
],
"256510": [
{
"from": "2024-03-20",
"to": "2024-03-27",
"min_stay": 2,
"pricing": [
{
"adults": 1,
"children": 0,
"price": 100
},
{
"adults": 2,
"children": 0,
"price": 125
},
{
"adults": 2,
"children": 1,
"price": 135
},
{
"adults": 3,
"children": 0,
"price": 150
}
]
},
{
"from": "2024-03-28",
"to": "2024-03-30",
"pricing": [
{
"adults": 1,
"children": 0,
"price": 100
},
{
"adults": 2,
"children": 0,
"price": 125
},
{
"adults": 2,
"children": 1,
"price": 135
},
{
"adults": 3,
"children": 0,
"price": 150
}
]
}
],
"257909": [
{
"from": "2024-03-20",
"to": "2024-03-30",
"pricing": [
{
"adults": 1,
"children": 0,
"price": 75
},
{
"adults": 2,
"children": 0,
"price": 100
},
{
"adults": 2,
"children": 1,
"price": 110
},
{
"adults": 2,
"children": 2,
"price": 120
},
{
"adults": 3,
"children": 0,
"price": 125
},
{
"adults": 3,
"children": 1,
"price": 135
},
{
"adults": 4,
"children": 0,
"price": 150
}
]
}
]
}
Response example for Single Rate request.
[
{
"from": "2024-03-20",
"to": "2024-03-30",
"min_stay": 2,
"pricing": [
{
"adults": 1,
"children": 0,
"price": 200
},
{
"adults": 2,
"children": 0,
"price": 250
}
]
}
]
