Get Booking List

Description: Get booking list

Path: /api/v1/reservation/getBookingList

Method: GET

Request

Attributes

* = required

hotelSn*

integer

Identify of hotel

startDate

string

Optional. Filter by checkInDatePlan Format: Y-m-d

endDate

string

Optional. Filter by checkInDatePlan Format: Y-m-d

bookingType

integer

Possible enum values: 1 = Hourly 2 = Overnight 3 = Daily

bookingStatus

integer

Possible enum values: 1 = Upcoming 9 = Checked-in 8 = Awaiting G2J Processing 4 = No-show 3 = Cancelled 2 = Completed 10 = Awaiting User Confirmation 5 = Pending Payment

keyword

string

Search by keyword based on bookingNo

bookingNoList

array

List of booking numbers. Each value separated by "," Note: To ensure reliable processing, please limit the number of bookings sent in each request to a maximum of 100~200.

page

integer

Page’s number

limit

integer

The maximum number of records to include on each page.

Response

Attributes

userBookingSn

integer

Identify of booking

bookingNo

string

Go2Joy’s Identity of booking

hotelSn

integer

Identify of hotel

hotelName

string

Hotel’s name

roomTypeSn

integer

Identify of room type

roomTypeName

string

Room type’s name

nickName

string

User’s nick name

mobile

string

Phone number of user

checkIn

string

Check-in time Format: Y-m-d H:i:s

checkOut

string

Check-out time Format: Y-m-d H:i:s

bookingType

integer

Possible enum values: 1 = Hourly 2 = Overnight 3 = Daily

bookingStatus

integer

Possible enum values: 1 = Upcoming 9 = Checked-in 8 = Awaiting G2J Processing 4 = No-show 3 = Cancelled 2 = Completed 10 = Awaiting User Confirmation 5 = Pending Payment

paymentWay

integer

Possible enum values: 2 = Pay at hotel 3 = Pay in advance

paymentStatus

integer

Possible enum values: 0 = Awaiting 1 = Successful 2 = Failed 3 = Refunded

totalAmount

integer

The total booking amount needs to be paid at once for this booking, including extra fee if you’re booking at high demand time. This does not include promotion such as flash sale, direct discount

totalGo2JoyDiscount

integer

Total discount from Go2Joy

totalHotelDiscount

integer

Total discount from Hotel

amountFromUser

integer

The total booking amount needs to be paid from user

couponName

string

Coupon’s name applied on this booking.

bonusHour

integer

Number of bonus hours

flashSale

boolean

Applied/Not applied flash sale

directDiscount

boolean

Applied/Not applied direct discount

highDemand

boolean

Applied/Not applied high demand

reasonForTransfer

string

The reason for transferred

reasonForCancellation

string

The reason for cancelled

reasonForNoShow

string

The reason for no-show

reasonForComplete

string

The reason for completed

createTime

string

Format: Y-m-d H:i:s

lastUpdate

string

Format: Y-m-d H:i:s

Example

{
    "code": 1,
    "message": "All went well, and (usually) some data was returned",
    "error": null,
    "data": {
        "bookingList": [
            {
                "userBookingSn": 1840550,
                "bookingNo": 1940550,
                "hotelSn": 725,
                "hotelName": "Bonita Tô Hiến Thành",
                "roomTypeSn": 169,
                "roomTypeName": "Fantasy VIP",
                "nickName": "Hùn Hùn",
                "mobile": null,
                "checkIn": "2025-05-19 22:00:00",
                "checkOut": "2025-05-19 23:00:00",
                "bookingType": 1,
                "bookingStatus": 2,
                "paymentWay": 3,
                "paymentStatus": 1,
                "totalAmount": 220000,
                "amountFromUser": 220000,
                "couponName": null,
                "bonusHour": false,
                "flashSale": false,
                "directDiscount": false,
                "highDemand": false,
                "reasonForTransfer": null,
                "reasonForCancellation": null,
                "reasonForNoShow": null,
                "reasonForComplete": null,
                "createTime": "2025-05-19 21:37:58",
                "lastUpdate": "2025-05-19 23:00:11"
            },
            {
                "userBookingSn": 1840532,
                "bookingNo": 1940532,
                "hotelSn": 725,
                "hotelName": "Bonita Tô Hiến Thành",
                "roomTypeSn": 170,
                "roomTypeName": "Dream Vip",
                "nickName": "Hùn Hùn",
                "mobile": null,
                "checkIn": "2025-05-08 14:00:00",
                "checkOut": "2025-05-09 12:00:00",
                "bookingType": 3,
                "bookingStatus": 3,
                "paymentWay": 3,
                "paymentStatus": 3,
                "totalAmount": 600000,
                "amountFromUser": 600000,
                "couponName": null,
                "bonusHour": false,
                "flashSale": false,
                "directDiscount": false,
                "highDemand": false,
                "reasonForTransfer": null,
                "reasonForCancellation": "The hotel is under repair / Temporarily closed",
                "reasonForNoShow": null,
                "reasonForComplete": null,
                "createTime": "2025-05-08 13:15:44",
                "lastUpdate": "2025-05-08 13:16:48"
            },
            {
                "userBookingSn": 1840531,
                "bookingNo": 1940531,
                "hotelSn": 725,
                "hotelName": "Bonita Tô Hiến Thành",
                "roomTypeSn": 170,
                "roomTypeName": "Dream Vip",
                "nickName": "Hùn Hùn",
                "mobile": null,
                "checkIn": "2025-05-08 13:30:00",
                "checkOut": "2025-05-08 14:30:00",
                "bookingType": 1,
                "bookingStatus": 3,
                "paymentWay": 3,
                "paymentStatus": 3,
                "totalAmount": 150000,
                "amountFromUser": 150000,
                "couponName": null,
                "bonusHour": false,
                "flashSale": false,
                "directDiscount": false,
                "highDemand": false,
                "reasonForTransfer": null,
                "reasonForCancellation": "The hotel is under repair / Temporarily closed",
                "reasonForNoShow": null,
                "reasonForComplete": null,
                "createTime": "2025-05-08 13:11:57",
                "lastUpdate": "2025-05-08 13:12:49"
            },
            {
                "userBookingSn": 1840528,
                "bookingNo": 1940528,
                "hotelSn": 725,
                "hotelName": "Bonita Tô Hiến Thành",
                "roomTypeSn": 170,
                "roomTypeName": "Dream Vip",
                "nickName": "Hùn Hùn",
                "mobile": null,
                "checkIn": "2025-05-08 13:30:00",
                "checkOut": "2025-05-08 14:30:00",
                "bookingType": 1,
                "bookingStatus": 8,
                "paymentWay": 3,
                "paymentStatus": 1,
                "totalAmount": 150000,
                "amountFromUser": 150000,
                "couponName": null,
                "bonusHour": false,
                "flashSale": false,
                "directDiscount": false,
                "highDemand": false,
                "reasonForTransfer": null,
                "reasonForCancellation": null,
                "reasonForNoShow": null,
                "reasonForComplete": null,
                "createTime": "2025-05-08 13:10:18",
                "lastUpdate": "2025-05-08 13:11:18"
            },
            {
                "userBookingSn": 1840202,
                "bookingNo": 1940202,
                "hotelSn": 725,
                "hotelName": "Bonita Tô Hiến Thành",
                "roomTypeSn": 170,
                "roomTypeName": "Dream Vip",
                "nickName": "Hùn Hùn",
                "mobile": null,
                "checkIn": "2025-04-21 14:00:00",
                "checkOut": "2025-04-22 12:00:00",
                "bookingType": 3,
                "bookingStatus": 4,
                "paymentWay": 3,
                "paymentStatus": 0,
                "totalAmount": 600000,
                "amountFromUser": 600000,
                "couponName": null,
                "bonusHour": false,
                "flashSale": false,
                "directDiscount": false,
                "highDemand": false,
                "reasonForTransfer": null,
                "reasonForCancellation": null,
                "reasonForNoShow": "KS: khach ko den",
                "reasonForComplete": null,
                "createTime": "2025-04-21 15:48:12",
                "lastUpdate": "2025-04-21 15:49:13"
            },
            {
                "userBookingSn": 1840195,
                "bookingNo": 1940195,
                "hotelSn": 725,
                "hotelName": "Bonita Tô Hiến Thành",
                "roomTypeSn": 170,
                "roomTypeName": "Dream Vip",
                "nickName": "Hùn Hùn",
                "mobile": null,
                "checkIn": "2025-04-21 14:00:00",
                "checkOut": "2025-04-22 12:00:00",
                "bookingType": 3,
                "bookingStatus": 8,
                "paymentWay": 3,
                "paymentStatus": 0,
                "totalAmount": 600000,
                "amountFromUser": 600000,
                "couponName": null,
                "bonusHour": false,
                "flashSale": false,
                "directDiscount": false,
                "highDemand": false,
                "reasonForTransfer": null,
                "reasonForCancellation": null,
                "reasonForNoShow": "KS: no show",
                "reasonForComplete": null,
                "createTime": "2025-04-21 14:52:33",
                "lastUpdate": "2025-04-21 15:25:30"
            },
            {
                "userBookingSn": 1840159,
                "bookingNo": 1940159,
                "hotelSn": 725,
                "hotelName": "Bonita Tô Hiến Thành",
                "roomTypeSn": 170,
                "roomTypeName": "Dream Vip",
                "nickName": "Hùn Hùn",
                "mobile": null,
                "checkIn": "2025-04-18 14:00:00",
                "checkOut": "2025-04-19 12:00:00",
                "bookingType": 3,
                "bookingStatus": 8,
                "paymentWay": 3,
                "paymentStatus": 0,
                "totalAmount": 600000,
                "amountFromUser": 600000,
                "couponName": null,
                "bonusHour": false,
                "flashSale": false,
                "directDiscount": false,
                "highDemand": false,
                "reasonForTransfer": null,
                "reasonForCancellation": null,
                "reasonForNoShow": null,
                "reasonForComplete": null,
                "createTime": "2025-04-18 10:36:27",
                "lastUpdate": "2025-04-18 10:36:56"
            }
        ],
        "meta": {
            "total": 8727,
            "perPage": 10,
            "currentPage": 1,
            "lastPage": 873,
            "from": 1,
            "to": 873
        }
    },
    "timestamp": 1749318180
}