Get a Quote
Get a quote for a given property or a room type id.
HTTP Request​
GET https://dev.calry.app/api/v2/vrs/quote/{propertyId}
Headers​
Header | Value |
---|---|
Authorization | Bearer YOUR_ACCESS_TOKEN |
workspaceId | YOUR_WORKSPACE_ID |
integrationAccountId | YOUR_INTEGRATION_ACCOUNT_ID |
Query Parameters​
Parameter | Type | Description |
---|---|---|
startDate | string | Required. The start date of the quote in YYYY-MM-DD format. |
endDate | string | Required. The end date of the quote in YYYY-MM-DD format. |
guests | number | Required. The number of guests. |
roomTypeId | string | Required. The room type Id associated with the property. |
promotionCode | string | Optional. The promotion code to apply to the quote. |
promotionCode
is only supported in Hostaway, Guesty Booking Engine and RentalWise integrations.
Example Request​
curl --location 'https://dev.calry.app/api/v2/vrs/quote/879613?startDate=2025-07-01&endDate=2025-07-10&guests=3&roomTypeId=879613&promotionCode=SUMMER10' \
--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",
"numberOfGuests": 3,
"arrivalDate": "2025-07-01",
"departureDate": "2025-07-10",
"currency": "USD",
"ratePlans": [
{
"totalPrice": 1168.7,
"deposit": 10,
"basePrice": {
"totalBasePrice": 1053,
"breakdown": [
{
"name": "Base rate",
"description": "Base rate",
"type": "BASE_PRICE",
"total": 873,
"isMandatory": false
},
{
"name": "Price for extra person",
"description": "Price for extra person",
"type": "PRICE_PER_GUEST",
"total": 180,
"isMandatory": false
}
]
},
"fee": {
"totalFee": 115,
"breakdown": [
{
"name": "Cleaning fee",
"description": "Cleaning fee",
"type": "CLEANING_FEE",
"total": 30,
"isMandatory": true
},
{
"name": "Additional Cleaning Fee",
"description": "Additional cleaning fee",
"type": "ADDITIONAL_CLEANING_FEE",
"total": 5,
"isMandatory": true
},
{
"name": "Booking fee",
"description": "Booking fee",
"type": "BOOKING_FEE",
"total": 1,
"isMandatory": true
},
{
"name": "credit",
"description": "Credit Card fee",
"type": "CREDIT_CARD_FEE",
"total": 1,
"isMandatory": true
},
{
"name": "Reservation change fee",
"description": "Reservation change fee",
"type": "RESERVATION_CHANGE_FEE",
"total": 1,
"isMandatory": true
},
{
"name": "Resort fee",
"description": "Resort fee",
"type": "RESORT_FEE",
"total": 1,
"isMandatory": true
},
{
"name": "Service",
"description": "Service fee",
"type": "SERVICE_FEE",
"total": 75,
"isMandatory": true
},
{
"name": "Tourism fee",
"description": "Tourism fee",
"type": "TOURISM_FEE",
"total": 1,
"isMandatory": true
}
]
},
"tax": {
"totalTax": 96,
"breakdown": [
{
"name": "City / Tourism tax",
"description": "City / Tourism tax",
"type": "CITY_TOURISM_TAX",
"total": 11,
"isMandatory": false
},
{
"name": "Hotel tax",
"description": "Hotel tax",
"type": "HOTEL_TAX",
"total": 11,
"isMandatory": false
},
{
"name": "Lodging tax",
"description": "Lodging tax",
"type": "LODGING_TAX",
"total": 11,
"isMandatory": false
},
{
"name": "Occupancy tax",
"description": "Occupancy tax",
"type": "TRANSIENT_OCCUPANCY_TAX",
"total": 11,
"isMandatory": false
},
{
"name": "Other taxes",
"description": "Other taxes",
"type": "OTHER_TAX",
"total": 11,
"isMandatory": false
},
{
"name": "Room tax",
"description": "Room tax",
"type": "ROOM_TAX",
"total": 11,
"isMandatory": false
},
{
"name": "Sales tax",
"description": "Sales tax",
"type": "SALES_TAX",
"total": 10,
"isMandatory": false
},
{
"name": "VAT / GST",
"description": "VAT / GST",
"type": "VAT_GST",
"total": 20,
"isMandatory": false
}
]
},
"discount": {
"totalDiscount": -105.3,
"breakdown": [
{
"name": "Coupon discount",
"description": "Coupon discount",
"type": "OTHER_DISCOUNT",
"total": -105.3,
"isMandatory": false
}
]
}
}
]
}
}