Subject
OwnerRez Important Update: Breaking Change to SpotRates Endpoint in V2 API
Body
Hi Jake!
We are writing to inform you of a breaking change to the V2 API that will affect the SpotRates endpoint. Starting March 1, 2025, the SpotRates endpoint will require the currency field to be explicitly specified for each rate. Please note that this update primarily affects dynamic pricing integrated apps (apps that push rates into OwnerRez). If your OAuth app does not push rates into OwnerRez, you can disregard this message.
What’s Changing
Previously, the SpotRates endpoint did not require a currency field. With this update, every rate entry must include a currency field in the following format:
{
"property_id": 123,
"date": "yyyy-mm-dd",
"amount": 123.00,
"currency": "USD"
}
This change ensures the currency provided matches the property's configured currency. It helps avoid issues caused by misconfigured or incorrect rate entries.
Key Dates
Now through February 29, 2025:
- If the currency field is omitted, the system will default to “USD”.
- No errors will be returned for missing or incorrect currency fields during this period.
March 1, 2025:
- Specifying the currency field becomes mandatory.
- We will begin validating the currency against the configured property currency. Any mismatched or missing currencies will result in errors. If a currency does not match, we will throw a validation ownerrezexception with a message that includes propertyId and expected currency.