Reservation
Get all reservations
Retrieves reservations with optional filters for listing, integration account, status, and check-in/check-out dates.
Authorization
x-calry-api-key x-calry-api-key<token>
In: header
Query Parameters
displayCurrency?string
Currency to display prices in (ISO 4217)
integrationAccountID?string
Filter by integration account ID
listingID?string
Filter by listing ID
status?string
Filter by reservation status
Value in
"INQUIRY" | "PENDING" | "CONFIRMED" | "MODIFIED" | "MOVED" | "CANCELLED" | "CANCELLATION_PENDING" | "EXPIRED" | "NO_SHOW" | "STAYING" | "POST_STAY" | "UNKNOWN" | "BLOCKED"checkInStartDate?string
Filter by check-in date starting from
Format
date-timecheckInEndDate?string
Filter by check-in date up to
Format
date-timecheckOutStartDate?string
Filter by check-out date starting from
Format
date-timecheckOutEndDate?string
Filter by check-out date up to
Format
date-timeHeader Parameters
x-calry-tenant-id?string
Optional tenant ID to specify which tenant to operate as. Controls which reservations are accessible. If not provided, the default tenant will be used.
Response Body
application/json
application/json
curl -X GET "https://example.com/api/v1/reservation"[
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"listingID": "123e4567-e89b-12d3-a456-426614174000",
"unitID": "123e4567-e89b-12d3-a456-426614174000",
"integrationAccountID": "123e4567-e89b-12d3-a456-426614174000",
"providerReservationID": "HMKYWB7BF8",
"providerID": "3827197",
"parentPropertyID": "PROP12345",
"checkInDate": "2025-06-15",
"checkOutDate": "2025-06-22",
"guests": 2,
"guest": {
"id": "G12345",
"name": "John Doe",
"firstName": "John",
"lastName": "Doe",
"email": "john.doe@example.com",
"phone": "+1234567890"
},
"adults": 2,
"children": 1,
"infants": 0,
"pets": 0,
"status": "CONFIRMED",
"source": "website",
"notes": "Guest requested early check-in if possible",
"originalCurrency": "USD",
"currency": "EUR",
"totalPrice": 880,
"components": {},
"createdAt": "2025-05-20T14:30:00.000Z",
"updatedAt": "2025-05-21T10:15:00.000Z",
"cancelledAt": "2025-05-25T09:45:00.000Z",
"confirmedAt": "2025-05-20T15:00:00.000Z",
"salesChannel": "direct",
"cancellationPolicy": {
"policyID": "string",
"name": "Moderate",
"version": 0,
"source": "LISTING_CHANNEL",
"salesChannel": "direct",
"timeZone": "Europe/Sofia",
"fixedAt": "2026-10-20T12:00:00.000Z",
"refundable": true,
"refundableTag": "RFN",
"freeCancellationUntil": "string",
"penalties": [
{
"from": "2026-11-30T13:00:00.000Z",
"percentage": 50,
"amount": 117,
"currency": "EUR"
}
],
"description": "Full refund if cancelled before 2026-11-30 15:00 (Europe/Sofia). No refund after that."
}
}
]Empty
{
"timestamp": "2025-03-05T11:45:49.631Z",
"path": "<URL_PATH>",
"message": "Authentication failed",
"details": []
}