Join our community at https://www.reddit.com/r/HotelByte/

HotelByte
HomepageWaitlist
HomepageWaitlist
Hotel Partners Roadmap
Submit issues
    • 1. Get started
      • Overview
      • Booking flow
      • Certification and Go Live
      • Frequently Asked Questions (FAQ)
    • 2. Guides
      • Quick start
      • Error handling
      • Rate limit
      • Certification cases
      • Test more scenarios
    • 3. API Reference
      • Authentication
        • Ticket
      • Content
        • Destinations
        • HotelStaticDetail
        • HotelsMetadata
      • Search
        • HotelList
        • HotelRates
      • Make bookings
        • CheckAvail
        • Book
      • Manage bookings
        • QueryOrders
        • Cancel
    • Schemas
      • Schemas
      • hotel.common.bff.Table
      • OrderHomeFunctionReq
      • TicketReq
      • TicketResp
      • DestinationInclude
      • DestinationExtra
      • Coordinates
      • CheckAvailReq
      • CheckAvailResp
      • HotelsMetadataListResp
      • HotelsMetadataReq
      • ComputedCancelPolicyItem
      • OrderHomeFunctionResp
      • OriginalRoomNaming
      • Rate
      • CancelResp
      • Tax
      • Holder
      • HotelOrder
      • OrderRoomRefundInfo
      • HotelListReq
      • HotelListResp
      • HotelListBasicInfo
      • BaseHeader
      • BookingHeader
      • ContentHeader
      • HotelMeta
      • DestinationType
      • Guest
      • DestinationsReq
      • DestinationsResp
      • OrderStatus
      • GuestPerRoom
      • RatePkgId
      • RoomRatePkg
      • HotelRatesReq
      • BookReq
      • HotelRatesResp
      • BookResp
      • CancelReq
      • QueryOrdersReq
      • HotelStaticDetailReq
      • QueryOrdersResp
      • HotelStaticDetailResp

    hotel.supplier.domain.HotelOrder(HotelOrder)

    {
        "status": 0,
        "statusRemark": "aborted",
        "checkIn": "now()",
        "checkOut": "now()+7",
        "nightCount": 0,
        "roomCount": 0,
        "bookingTime": "2026-01-01T10:00:00Z",
        "hotelConfirmNo": "123456",
        "holder": {
            "email": "johndoe@example.com",
            "firstName": "John",
            "lastName": "Doe",
            "phone": {
                "countryCode": "1",
                "number": "1234567890"
            }
        },
        "platformReferenceNo": "1234567890",
        "customerReferenceNo": "1234567890",
        "hotel": {
            "hotelId": "string",
            "destinationId": "804028047",
            "name": {
                "en": "Jumeirah Beach Hotel"
            },
            "rating": 4.5,
            "address": {
                "en": "Millenium Al Barsha"
            },
            "latlngCoordinator": {
                "google": {
                    "lat": 25.0478,
                    "lng": 121.5319
                },
                "gaode": {
                    "lat": 25.0478,
                    "lng": 121.5319
                }
            },
            "logoURL": "https://static.hotelbyte.com/Images/Hotel/804028047_1.jpg"
        },
        "rooms": [
            {
                "roomTypeId": "string",
                "roomTypeName": {
                    "en": "string",
                    "zh": "string",
                    "ar": "string"
                },
                "hotelId": "string",
                "rates": [
                    {
                        "ratePkgId": "string",
                        "refundableMode": "full",
                        "refundableUntil": "2006-01-02T15:04:05Z07:00",
                        "cancelFees": [
                            {
                                "until": "2006-01-02T15:04:05Z07:00",
                                "fee": {
                                    "currency": "string",
                                    "amount": 0
                                }
                            }
                        ],
                        "originalRoomNaming": {
                            "id": "string",
                            "name": "string",
                            "supplier": 0
                        },
                        "rate": {
                            "commissionableRate": {
                                "currency": "string",
                                "amount": 0
                            },
                            "netRate": {
                                "currency": "string",
                                "amount": 0
                            },
                            "grossRate": {
                                "currency": "string",
                                "amount": 0
                            },
                            "respectGrossRate": true
                        },
                        "totalRate": {
                            "commissionableRate": {
                                "currency": "string",
                                "amount": 0
                            },
                            "netRate": {
                                "currency": "string",
                                "amount": 0
                            },
                            "grossRate": {
                                "currency": "string",
                                "amount": 0
                            },
                            "respectGrossRate": true
                        },
                        "rateComment": "string",
                        "includesPackaging": true,
                        "checkIn": "now()",
                        "checkOut": "now()+7",
                        "board": {
                            "boardId": "RO",
                            "boardName": {
                                "en": "string",
                                "zh": "string",
                                "ar": "string"
                            },
                            "boardDesc": {
                                "en": "string",
                                "zh": "string",
                                "ar": "string"
                            }
                        },
                        "tax": {
                            "total": {
                                "currency": "string",
                                "amount": 0
                            },
                            "items": [
                                {
                                    "taxType": "string",
                                    "taxName": "string",
                                    "amount": {
                                        "currency": "string",
                                        "amount": 0
                                    },
                                    "desc": "string"
                                }
                            ]
                        }
                    }
                ],
                "ratePkgId": "string",
                "refundableMode": "full",
                "refundableUntil": "2006-01-02T15:04:05Z07:00",
                "cancelFees": [
                    {
                        "until": "2006-01-02T15:04:05Z07:00",
                        "fee": {
                            "currency": "string",
                            "amount": 0
                        }
                    }
                ],
                "originalRoomNaming": {
                    "id": "string",
                    "name": "string",
                    "supplier": 0
                },
                "rate": {
                    "commissionableRate": {
                        "currency": "string",
                        "amount": 0
                    },
                    "netRate": {
                        "currency": "string",
                        "amount": 0
                    },
                    "grossRate": {
                        "currency": "string",
                        "amount": 0
                    },
                    "respectGrossRate": true
                },
                "totalRate": {
                    "commissionableRate": {
                        "currency": "string",
                        "amount": 0
                    },
                    "netRate": {
                        "currency": "string",
                        "amount": 0
                    },
                    "grossRate": {
                        "currency": "string",
                        "amount": 0
                    },
                    "respectGrossRate": true
                },
                "rateComment": "string",
                "includesPackaging": true,
                "checkIn": "now()",
                "checkOut": "now()+7",
                "board": {
                    "boardId": "RO",
                    "boardName": {
                        "en": "string",
                        "zh": "string",
                        "ar": "string"
                    },
                    "boardDesc": {
                        "en": "string",
                        "zh": "string",
                        "ar": "string"
                    }
                },
                "tax": {
                    "total": {
                        "currency": "string",
                        "amount": 0
                    },
                    "items": [
                        {
                            "taxType": "string",
                            "taxName": "string",
                            "amount": {
                                "currency": "string",
                                "amount": 0
                            },
                            "desc": "string"
                        }
                    ]
                },
                "roomIndex": 0,
                "guests": [
                    {
                        "roomIndex": 0,
                        "firstName": "John2",
                        "lastName": "Doe",
                        "nationalityCode": "US",
                        "age": 18,
                        "isChild": false
                    }
                ],
                "refundInfo": [
                    {
                        "date": "string",
                        "refunded": true,
                        "refundedMoney": {
                            "currency": "string",
                            "amount": 0
                        }
                    }
                ]
            }
        ]
    }
    Built with