Returns reservations for a property, newest booking first. Each reservation carries its booking,
occupancy, rooms, rate plan, status, source, OTA reference and every guest named on it. Guest
contact details are returned unmasked.
Guest rows include date of birth, home address and profile contact details; reservations:read
is sufficient. Passport details are returned only to tokens that also carry guests:read, and are null otherwise.
reservationNo returns the one reservation with that number, in the same paginated shape.
Each date pair filters on its own date and is inclusive; a "To" value without a time stops at
midnight, so add T23:59:59 to include the whole day. All filters combine with AND.
Sample requests:
GET /api/v2/reservations?companyId=WS&bookedFrom=2026-10-01&bookedTo=2026-10-31T23:59:59
GET /api/v2/reservations?companyId=WS&arrivalFrom=2026-10-19&arrivalTo=2026-10-19T23:59:59&status=Confirmed
GET /api/v2/reservations?companyId=WS&reservationNo=20387
GET /api/v2/reservations?companyId=WS&cancelledFrom=2026-10-01&cancelledTo=2026-10-31T23:59:59
GET /api/v2/reservations?companyId=WS&arrivalFrom=2026-10-01&arrivalTo=2026-10-31T23:59:59&status=NoShow
Headers:
Authorization: Bearer
Authorization: Bearer ********************curl --location 'https://uat-api.wincloudone.com/stdinterface/api/v2/reservations?companyId=&bookedFrom=&bookedTo=&arrivalFrom=&arrivalTo=&departureFrom=&departureTo=&cancelledFrom=&cancelledTo=&status=&roomTypeId=&planId=&bookingNo=&reservationNo=&guestName=&mobile=&email=&page=&pageSize=' \
--header 'Authorization: Bearer <token>'{
"success": true,
"message": "string",
"errorCode": "string",
"statusCode": 0,
"data": {
"items": [
{
"bookingNo": 0,
"reservationNo": 0,
"onlineBookingRefNo": "string",
"otaReference": {
"otaId": "string",
"referenceNo": "string"
},
"booking": {
"reservationDate": "2019-08-24T14:15:22.123Z",
"arrivalDate": "2019-08-24T14:15:22.123Z",
"arrivalTime": "string",
"departureDate": "2019-08-24T14:15:22.123Z",
"departureTime": "string",
"nights": 0,
"roomsBooked": 0,
"currency": {
"code": "string",
"name": "string",
"isoCode": "string"
},
"bookedBy": "string",
"contactEmail": "string",
"contactMobile": "string",
"contactTelephone": "string",
"depositAmount": 0,
"totalRoomRate": 0
},
"actualArrivalDate": "2019-08-24T14:15:22.123Z",
"actualArrivalTime": "string",
"actualDepartureDate": "2019-08-24T14:15:22.123Z",
"actualDepartureTime": "string",
"lateCheckOutFlag": true,
"walkInIndicator": true,
"partyName": "string",
"vipStatus": {
"code": "string",
"name": "string"
},
"occupancy": {
"adults": 0,
"children": 0,
"infants": 0,
"pax": 0
},
"guestsOnStay": 0,
"roomType": {
"code": "string",
"name": "string"
},
"reservedRoom": "string",
"rooms": [
{
"registrationNo": 0,
"roomNo": "string",
"guestId": 0,
"roomType": {
"code": "string",
"name": "string"
},
"ratePlan": {
"planId": "string",
"planName": "string",
"rateTypeId": "string",
"rateTypeName": "string"
},
"occupancy": {
"adults": 0,
"children": 0,
"infants": 0,
"pax": 0
},
"checkIn": {
"date": "2019-08-24T14:15:22.123Z",
"time": "string",
"by": "string",
"arrivalFrom": "string",
"arrivalFlight": "string"
},
"checkOut": {
"date": "2019-08-24T14:15:22.123Z",
"time": "string",
"departTo": "string",
"departureFlight": "string",
"instructions": "string"
}
}
],
"ratePlan": {
"planId": "string",
"planName": "string",
"rateTypeId": "string",
"rateTypeName": "string"
},
"chargeRate": 0,
"tariff": 0,
"packageAmount": 0,
"foreignRate": 0,
"payMode": "string",
"guestBalance": 0,
"status": {
"bookingStatus": "string",
"cancellation": {
"cancellationNo": 0,
"date": "2019-08-24T14:15:22.123Z",
"reason": "string",
"requestedBy": "string",
"cancelledBy": "string"
}
},
"source": {
"channel": "string",
"businessSourceId": "string",
"businessSourceName": "string",
"marketSegmentId": "string",
"marketSegmentName": "string",
"reservationModeId": "string",
"reservationModeName": "string",
"travelAgentId": "string",
"travelAgentName": "string"
},
"specialRequests": {
"reservationInstructions": "string",
"instructions": "string",
"foInstruction": "string",
"posInstruction": "string",
"guestSpecialRequest": "string",
"message": "string",
"remarks": "string"
},
"guestDetails": [
{
"guestSno": 0,
"reservationNo": 0,
"guestId": 0,
"title": {
"code": "string",
"name": "string"
},
"firstName": "string",
"lastName": "string",
"gender": {
"code": "string",
"name": "string"
},
"mobile": "string",
"email": "string",
"dateOfBirth": "2019-08-24T14:15:22.123Z",
"country": {
"code": "string",
"name": "string",
"isoCode": "string"
},
"nationality": {
"code": "string",
"name": "string",
"isoCode": "string"
},
"guestType": "string",
"address": {
"line1": "string",
"line2": "string",
"line3": "string",
"postalCode": "string"
},
"passport": {
"number": "string",
"issuePlace": "string",
"issueDate": "2019-08-24T14:15:22.123Z",
"expiryDate": "2019-08-24T14:15:22.123Z"
}
}
],
"lastModifiedDate": "2019-08-24T14:15:22.123Z"
}
],
"pageNumber": 0,
"pageSize": 0,
"totalCount": 0,
"totalPages": 0,
"hasPrevious": true,
"hasNext": true
},
"timestamp": "2019-08-24T14:15:22.123Z",
"correlationId": "string"
}