Get Availability

Get availability and nightly rate of a property or a room type for a given date range.

HTTP Request

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

Headers

Header	Value
Authorization	Bearer YOUR_ACCESS_TOKEN
workspaceId	YOUR_WORKSPACE_ID
integrationAccountId	YOUR_INTEGRATION_ACCOUNT_ID

Query Parameters

Parameter	Type	Description
rates	bool	Required. Determines whether nightly rates and stay information should be included in the response.
startDate	string	Required. The start date of the availability check in YYYY-MM-DD format.
endDate	string	Required. The end date of the availability check in YYYY-MM-DD format.
roomTypeId	string	Required. Unique Identifier of the room type for which availability check is done.

Example Request

curl --location 'https://dev.calry.app/api/v2/vrs/availability/212815?startDate=2025-07-01&endDate=2025-07-10&roomTypeId=212815&rates=true' \
--header 'Authorization: Bearer eyJraWQiOiJzLWJhNjY5YzZhLTE0OTktNDQ1MS05MjFhLTExYzQyNDZhZTQ1NSIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjMwMDAvYXV0aCIsInVzZXJJZCI6IjE2NjI0N2U3LTNiYjktNDExYy05ZDBjLTBjMDY3ZTg0ODhmNCIsIndvcmtzcGFjZUlkIjoiZjAzYzNjOTctNDJjZC00MzMwLTk5OWMtZmM5OTA2ZDgzMzY1IiwibmFtZSI6InNhZGFzIiwic291cmNlIjoibWljcm9zZXJ2aWNlIiwiaWF0IjoxNzA1OTI4ODQ5LCJleHAiOjIyOTA4MTMwMDUxfQ.Vft46kRiDKRXA8u7iOB1USkvECs3bI5qmT0kpU2cpogONrg0HFfoUNj658uBRLoyoUr_tq2TrUqf7S1MGqf58I_1zlpKJ0-7wLlKCA5atWGXDPJqaY6xqsJGwqf3z6Yb1QR7o_r3YsLUizSzHc7BT2wFdHaIBydUyNG_kQEogyFWieMTNFFHwU0aUq1LoSyyIL5nWoDeM-pFd0nd659_HOP1ZlvJIGWjVYB94-IrF1q-i4NKokhx6WEaftuIpSKLEsJAskuDWIzvittcq4RszAvaAVHUOKZd907JASGNpzBF812vggr_HmXVAxdVSo5cmzexh-fcgXfe8npXgkiEhg' \
--header 'workspaceId: f03c3c97-42cd-4330-999c-fc9906d83365' \
--header 'integrationAccountId: 526bcda0-7312-449f-8525-66048fd03fb7'

Example Response

{
    "success": true,
    "data": {
        "propertyId": "212815",
        "roomTypeId": "212815",
        "dateWiseAvailability": [
            {
                "date": "2025-07-01",
                "unitsAvailable": 0,
                "status": "NOT_AVAILABLE",
                "price": {
                    "amount": 130
                },
                "minimumNights": 3,
                "reservationIds": [
                    "37912498"
                ]
            },
            {
                "date": "2025-07-02",
                "unitsAvailable": 0,
                "status": "NOT_AVAILABLE",
                "price": {
                    "amount": 108
                },
                "minimumNights": 3,
                "reservationIds": [
                    "37912498"
                ]
            },
            {
                "date": "2025-07-03",
                "unitsAvailable": 1,
                "status": "AVAILABLE",
                "price": {
                    "amount": 102
                },
                "minimumNights": 3,
                "reservationIds": []
            },
            {
                "date": "2025-07-04",
                "unitsAvailable": 0,
                "status": "NOT_AVAILABLE",
                "price": {
                    "amount": 102
                },
                "minimumNights": 3,
                "reservationIds": [
                    "37912762"
                ]
            },
            {
                "date": "2025-07-05",
                "unitsAvailable": 0,
                "status": "NOT_AVAILABLE",
                "price": {
                    "amount": 97
                },
                "minimumNights": 3,
                "reservationIds": [
                    "37912762"
                ]
            },
            {
                "date": "2025-07-06",
                "unitsAvailable": 1,
                "status": "AVAILABLE",
                "price": {
                    "amount": 100
                },
                "minimumNights": 3,
                "reservationIds": []
            },
            {
                "date": "2025-07-07",
                "unitsAvailable": 1,
                "status": "AVAILABLE",
                "price": {
                    "amount": 74
                },
                "minimumNights": 3,
                "reservationIds": []
            },
            {
                "date": "2025-07-08",
                "unitsAvailable": 0,
                "status": "NOT_AVAILABLE",
                "price": {
                    "amount": 74
                },
                "minimumNights": 3,
                "reservationIds": [
                    "37950646",
                    "38089087"
                ]
            },
            {
                "date": "2025-07-09",
                "unitsAvailable": 0,
                "status": "NOT_AVAILABLE",
                "price": {
                    "amount": 86
                },
                "minimumNights": 3,
                "reservationIds": [
                    "37950646",
                    "38089087"
                ]
            },
            {
                "date": "2025-07-10",
                "unitsAvailable": 1,
                "status": "AVAILABLE",
                "price": {
                    "amount": 74
                },
                "minimumNights": 3,
                "reservationIds": []
            }
        ]
    }
}