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

Get Reservation

GET
https://uat-api.wincloudone.com/stdinterface/api/v2/reservations/{bookingNo}
Reservations v2
Last modified:2026-11-11 05:51:53

Returns every reservation sharing the number, each in the same shape as an item of the list.
A group booking shares one booking number, so it returns one item per reservation in the group.
Pass reservationNo to get just one of them; a number that is not part of the booking returns 404.

Sample request:

GET /api/v2/reservations/8381?companyId=WS
GET /api/v2/reservations/8381?companyId=WS&reservationNo=20387
Headers:
Authorization: Bearer

Request

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

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=&reservationNo=' \
--header 'Authorization: Bearer <token>'

Responses

🟢200
application/json
Returns the reservations
Body

Example
{
    "success": true,
    "message": "string",
    "errorCode": "string",
    "statusCode": 0,
    "data": [
        {
            "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"
        }
    ],
    "timestamp": "2019-08-24T14:15:22.123Z",
    "correlationId": "string"
}
🟠400
🟠401
🟠403
🟠404
🔴500
Modified at 2026-11-11 05:51:53
Previous
List Reservations
Next
Get Rooms
Built with