Get All Availabilities

Get all properties that are available during a given date range. This also incudes number of guests and country.

HTTP Request

GET https://dev.calry.app/api/v1/vrs/availability

Headers

Header	Value
Authorization	Bearer YOUR_ACCESS_TOKEN
workspaceId	YOUR_WORKSPACE_ID
integrationAccountId	YOUR_INTEGRATION_ACCOUNT_ID

Query Parameters

Parameter	Type	Description
startDate	Required string (YYYY-MM-DD)	The start date of the quote.
endDate	Required string (YYYY-MM-DD)	The end date of the quote.
guests	Optional int	The number of guests.
country	Optional string	The country of the property.

Example Request

curl --location 'https://dev.calry.app/api/v1/vrs/availability?startDate=2024-02-01&endDate=2024-02-05' \
--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

{
    "data": {
        "arrivalDate": "2024-02-01",
        "departureDate": "2024-02-05",
        "numberOfGuests": null,
        "country": null,
        "propertyCount": 1,
        "properties": [
            {
                "propertyId": 234196,
                "name": "Welcome to your away from home!",
                "internalName": "Welcome to your away from home!",
                "description": "Nestled in the heart of the city, our stylish and comfortable one-bedroom apartment is perfect for couples or solo travelers. You'll sleep soundly in a queen-sized bed with high-quality linens. Step outside and find yourself within walking distance of vibrant cafes, art galleries, and boutique shops. We provide free Wi-Fi, a coffee machine with a selection of blends, and a guidebook with our personal recommendations to help you make the most of your stay.",
                "thumbnailUrl": "https://a0.muscache.com/im/pictures/miso/Hosting-1039697460153549535/original/7ab95483-0e36-4746-9ea7-87beb5b5d477.png?aki_policy=x_small",
                "pictures": [
                    {
                        "url": "https://hostaway-platform.s3.us-west-2.amazonaws.com/listing/84492-234196-ihOW2O9jaHdyosXX9j40KbpqquZGpQJ7FevZUWaQOQA-65aea5fc4ae69",
                        "description": ""
                    },
                    {
                        "url": "https://hostaway-platform.s3.us-west-2.amazonaws.com/listing/84492-234196-sS4yQ28hQhWZW9PYpKKwhcbhHKptc6sE286-E3b8s24-65aeab6d101f8",
                        "description": ""
                    },
                    {
                        "url": "https://hostaway-platform.s3.us-west-2.amazonaws.com/listing/84492-234196-DQj5GTWlDr4MOGCzX7DFLvNfDzhrBLGCjWs8GFwOZeU-65aeaade405b9",
                        "description": ""
                    },
                    {
                        "url": "https://hostaway-platform.s3.us-west-2.amazonaws.com/listing/84492-234196-oW2uY59O-QXxsFnF0dYoN3yrX--Het-SpeC-3-Dzz3Rg-65aea76ee0fcb",
                        "description": ""
                    },
                    {
                        "url": "https://hostaway-platform.s3.us-west-2.amazonaws.com/listing/84492-234196-zPKcxFIhQZUQXqiRLq8Kym6M1m12EE6IRyWzGn99naM-65aea76918250",
                        "description": ""
                    }
                ],
                "address": {
                    "line1": "31st Main Road Flat 102",
                    "line2": "31st Main Road",
                    "postal_code": "560102",
                    "city": "Bengaluru",
                    "state": "Karnataka",
                    "country": "India"
                },
                "geolocation": {
                    "latitude": 12.9140432,
                    "longitude": 77.6536595
                },
                "language": "en",
                "maximumNights": 365,
                "minimumNights": 1,
                "maxOccupancy": 4,
                "numberOfChildren": null,
                "numberOfInfants": null,
                "numberOfPets": null,
                "startPrice": 900,
                "currency": "INR",
                "timeZone": "Asia/Kolkata",
                "rating": {
                    "average": 0,
                    "count": null
                },
                "rooms": {
                    "type": "shared_room",
                    "bedroom": {
                        "count": 1,
                        "bedsCount": 2
                    },
                    "bathroom": {
                        "type": "private",
                        "count": 2
                    }
                }
            }
        ]
    }
}