Skip to main content

Update Availability

Update the availability of a property or a room type for a given date range.

HTTP Request​

PUT https://dev.calry.app/api/v2/vrs/availability/{propertyId}

Headers​

HeaderValue
AuthorizationBearer YOUR_ACCESS_TOKEN
workspaceIdYOUR_WORKSPACE_ID
integrationAccountIdYOUR_INTEGRATION_ACCOUNT_ID

Request Body​

FieldTypeDescription
propertyIdstring/numberRequired. Unique Identifier of the property.
roomTypeIdstring/numberRequired. Unique Identifier of the room-type.
startDatestringRequired. Start date in YYYY-MM-DD format.
endDatestringRequired. End date in YYYY-MM-DD format.
statusstringOptional. Status of the availability - AVAILABLE or NOT AVAILABLE.
amountnumberOptional. Nightly rate of the property.
minimumNightsnumberOptional. The minimum nights for the stay.
  • Note if you want to update the availability of a property for a single date, you can pass the same date in startDate and endDate parameters.
  • Note that status of the property is set to AVAILABLE by default unless you update it.

Example Request​

curl --location --request PUT 'https://dev.calry.app/api/v2/vrs/availability/416098' \
--header 'Authorization: Bearer eyJraWQiOiJzLWMwMzE2MzExLTg3NDktNGNhMC05NDg0LTBlNWM1ZDVlMDExOSIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJpc3MiOiJodHRwczovL2Rldi5jYWxyeS5hcHAvYXBpL2F1dGgiLCJ1c2VySWQiOiJjNjhmODE5My1lNjEwLTQ2NjItOTc1OC1kNmYxMmFhODAwODYiLCJ3b3Jrc3BhY2VJZCI6IjE0ODc3OTZkLTNmY2QtNGE2Mi04ODRhLTNhYWJhNTA3ZTczMiIsIm5hbWUiOiJ0ZXN0IGtleSIsInNvdXJjZSI6Im1pY3Jvc2VydmljZSIsImlhdCI6MTczOTQ0MjQyOCwiZXhwIjoyMDk5NDQyNDI4fQ.GqMhwGuSaaxYlimlJ875jGcOaeHEOGCxRlU0AcRhN7dlhTWErqwup1EeK4e2AfIs_d2KaI-22-5B3u-lDI125jBNRj0tT1OAQbbpELoyrrjMyBJdtx9185Q-j7r9ru4dFs9o_PXuK4ZWAD6XT_o9WU6YWvSqhxULGT2Yr2JMQ6Ic-n2DEn6OpoAjzLmID5tKqtTfhJP7MhyxgYUhDtFW7ong3DF3WznC81fGYCoALqzkoYzsSABqFsgLHNRIFhGWCMBqM0ZottfYlThhrZTQVQLyTureX-f4GpKmhmwcyEk8L3nD_5ZcznLEoiSjw8r0IXVkq-0u-VqF1_A' \
--header 'workspaceId: 1487796d-3fcd-4a62-884a-3aaba507e732' \
--header 'integrationAccountId: e327b0bA-8a8c-4379-8766-f6c3874e9d74' \
--header 'Content-Type: application/json' \
--data '{
"propertyId": "416098",
"roomTypeId: "608232",
"startDate": "2025-03-05",
"endDate": "2025-03-10",
"amount": 350,
"minimumNights": 3
}'

Example Response​

{
"success": true,
"data": {
"propertyId": "500008838",
"roomTypeId": "6031121",
"startDate": "2024-08-19",
"endDate": "2024-08-19",
"amount": 2000,
"status": "NOT_AVAILABLE"
}
}