1. Reservations v2
WinCloud API
  • Getting Started
    • Introduction
    • Quick Start
    • Authentication
    • General
    • Changelog
    • Privacy Policy
    • Terms of Service
    • Support
  • APIs
    • Guests
      • Search Guests
      • Create Guest
      • Get Guest Details
      • Update Guest
      • Get Guest Reservations
      • Get Guest Reference Data
    • Inventory
      • Get Room Inventory
      • Get Room Inventory Details
      • Update Room Inventory
    • Properties
      • Get Customer Properties
      • Get Property Configuration
    • Rates
      • Get Rate Adjustment Templates
      • Get Master Rates
      • Post Master Rates
      • Post Individual Rates
    • Reference Data
      • Get Countries
      • Get Payment Gateways
      • Get Payment Methods
      • Get Currencies
    • Reservations v1
      • Get Reservations
      • Get Cancelled Reservations
      • Get No-Show Reservations
      • Get Reservation Statuses
      • Update Special Instructions
    • Reservations v2
      • List Reservations
        GET
      • Get Reservation
        GET
    • Rooms
      • Get Rooms
      • Get Room Types
      • Get Rooms Extra Charges
      • Get Rooms Feature Types
      • Get Rooms Tariffs
      • Get Room and Revenue Performance
    • Travel Agents
      • Get Active Travel Agents
    • POS
      • Get Outlet Menu
    • Booking Analytics
      • Get Arrival Summary
      • Get Booking Summary
    • Schemas
      • CodeNameDto
      • ArrivalFiguresDto
      • CompanyDto
      • ArrivalSummaryDto
      • CompanyDtoPaginatedResponse
      • ArrivalSummaryDtoApiResponse
      • CompanyDtoPaginatedResponseApiResponse
      • BookingSummaryDto
      • CountryDto
      • ConfigurationOutletDto
      • BookingSummaryDtoApiResponse
      • CountryDtoApiResponse
      • ConfigurationRoomTypeDto
      • CountryRefDto
      • CurrencyDto
      • CurrencyDtoPaginatedResponse
      • CurrencyDtoPaginatedResponseApiResponse
      • ExtraChargeDto
      • ExtraChargeDtoApiResponse
      • FeatureTypeDto
      • CurrencyRefDto
      • FeatureTypeDtoPaginatedResponse
      • FeatureTypeDtoPaginatedResponseApiResponse
      • GuestCreatedDto
      • GuestAddressDto
      • GuestCreatedDtoApiResponse
      • GuestLookupsDto
      • GuestLookupsDtoApiResponse
      • DepartureFiguresDto
      • GuestPhoneDto
      • GuestPreferencesDto
      • GuestProfileDtoApiResponse
      • GuestProfileDto
      • GuestReservationDtoPaginatedResponse
      • GuestReservationDtoPaginatedResponseApiResponse
      • GuestStaySummaryDto
      • GuestReservationDto
      • GuestProfileRequestDto
      • GuestSummaryItemDto
      • GuestSummaryItemDtoPaginatedResponse
      • GuestPassportDto
      • GuestSummaryItemDtoPaginatedResponseApiResponse
      • InventoryRoomTypeDto
      • InventorySnapshotDto
      • InventorySnapshotDtoPaginatedResponse
      • InventorySnapshotDtoPaginatedResponseApiResponse
      • LanguageRefDto
      • MasterRateBlockDto
      • MasterRateTypeDto
      • MasterRateTypeDtoPaginatedResponse
      • MasterRateTypeDtoPaginatedResponseApiResponse
      • LinkedGuestDto
      • MealPlanDto
      • ObjectApiResponse
      • PayMethodDto
      • PayMethodDtoPaginatedResponse
      • OtaReferenceDto
      • PayMethodDtoPaginatedResponseApiResponse
      • PaymentGatewayDto
      • PaymentGatewayDtoPaginatedResponse
      • PaymentGatewayDtoPaginatedResponseApiResponse
      • ProblemDetails
      • PosMenuItemDto
      • RateAdjustmentTemplateDto
      • PosMenuItemDtoPaginatedResponse
      • RateAdjustmentTemplateDtoPaginatedResponse
      • PosMenuItemDtoPaginatedResponseApiResponse
      • RateAdjustmentTemplateDtoPaginatedResponseApiResponse
      • RatePlanRefDto
      • RecentReservationsDto
      • ReservationBillingDto
      • ReservationCancellationDto
      • PropertyConfigurationDto
      • ReservationEventDtoPaginatedResponse
      • PropertyConfigurationDtoApiResponse
      • ReservationEventDtoPaginatedResponseApiResponse
      • ReservationSourceDto
      • ReservationStatusDto
      • ReservationDtoApiResponse
      • ReservationDtoListApiResponse
      • ReservationStatusDtoListApiResponse
      • ReservationDtoPaginatedResponse
      • ReservationStayStatusDto
      • ReservationDtoPaginatedResponseApiResponse
      • RoomAssignmentItemDto
      • ReservationBookingDto
      • RoomCheckInDto
      • RoomCheckOutDto
      • RoomDto
      • RoomDtoPaginatedResponse
      • RoomDtoPaginatedResponseApiResponse
      • ReservationEventDto
      • RoomInventoryUpdateRequestDto
      • RoomInventoryUpdateResponseDto
      • RoomInventoryUpdateResponseDtoApiResponse
      • RoomRateDto
      • ReservationDto
      • RoomRateDtoPaginatedResponse
      • RoomRateDtoPaginatedResponseApiResponse
      • ReservationRoomDto
      • RoomRateFailureDto
      • RoomRateItemDto
      • RoomRateUpdateRequestDto
      • RoomRateUpdateResponseDto
      • RoomRateUpdateResponseDtoApiResponse
      • ReservationGuestDto
      • RoomTypeDto
      • ReservationOccupancyDto
      • RoomTypeDtoPaginatedResponse
      • RoomTypeDtoPaginatedResponseApiResponse
      • RoomTypeRefDto
      • StaySpendDto
      • TemplateDateRangeDto
      • TitleRefDto
      • TravelAgentDto
      • RoomPerformanceComparisonDto
      • TravelAgentDtoPaginatedResponse
      • RoomPerformanceMetricsDto
      • TravelAgentDtoPaginatedResponseApiResponse
      • RoomPerformancePeriodDto
      • UpdateMasterRatesRequestDto
      • RoomPerformanceResponseDto
      • UpdateMasterRatesResultDto
      • RoomPerformanceResponseDtoApiResponse
      • UpdateMasterRatesResultDtoApiResponse
      • UpdateReservationRequestDto
      • UpdateReservationResponseDtoApiResponse
      • RoomTypePerformanceDto
      • UpdateReservationResponseDto
      • SpecialRequestsDto
  • MCP
    • Overview
    • Connect Your AI Assistant
  • Webhooks
    • Set Up and Edit Webhooks
    • Verify Webhook Signatures
    • List of Webhook Events
  1. Reservations v2

List Reservations

GET
https://uat-api.wincloudone.com/stdinterface/api/v2/reservations
Reservations v2
Last modified:2026-11-13 03:52:04

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

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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>'

Responses

🟢200
application/json
Returns the paginated list of reservations
Body

Example
{
    "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"
}
🟠400
🟠401
🟠403
🔴500
Modified at 2026-11-13 03:52:04
Previous
Update Special Instructions
Next
Get Reservation
Built with