Lấy danh sách booking
Lấy danh sách các booking trong một khoảng thời gian nhất định, hỗ trợ phân trang và lọc theo loại ngày.
Endpoint
POST /api/v1/booking-list
Request
| Trường | Mô tả | Kiểu dữ liệu / Định dạng |
|---|---|---|
| from_date | Ngày bắt đầu | YYYY-MM-DD |
| to_date | Ngày kết thúc | YYYY-MM-DD |
| page | Trang hiện tại | int |
| per_page | Số lượng bản ghi trên mỗi trang | int |
| date_filter_by | Lọc theo loại ngày: - BOOKING_DATE: Ngày booking - CREATED_DATE: Ngày tạo | string |
Example Request
{
"from_date": "2026-01-01",
"to_date": "2026-01-27",
"page": 1,
"per_page": 10,
"date_filter_by": "BOOKING_DATE"
}
Response
| Trường | Mô tả | Kiểu dữ liệu / Giá trị |
|---|---|---|
| bookings | Danh sách booking | array |
| bookings[].booking_id | ID booking | string |
| bookings[].booking_date | Ngày Booking | YYYY-MM-DD |
| bookings[].booking_code | Mã booking | string |
| bookings[].payment_status | Trạng thái thanh toán | string |
| bookings[].total_amount | Tổng tiền | double |
| bookings[].note | Ghi chú | string |
| bookings[].status | Trạng thái booking | string |
| bookings[].created_at | Thời gian tạo (Unix Timestamp) | int |
| bookings[].is_grouped | Vé đoàn | bool |
| bookings[].customer | Thông tin khách hàng | object |
| bookings[].packages | Thông tin gói bán trong booking | array |
| bookings[].tickets | Danh sách vé (nếu booking đã xuất vé) | array |
| bookings[].tickets[].price | Giá vé | double |
| bookings[].tickets[].e-invoice_code | Mã tra cứu hóa đơn điện tử | string |
| pagination | Thông tin phân trang | object |
| pagination.total | Tổng số bản ghi | int |
| pagination.per_page | Số bản ghi trên mỗi trang | int |
| pagination.current_page | Trang hiện tại | int |
| pagination.last_page | Trang cuối cùng | int |
Example Response
{
"success": true,
"code": 1000,
"data": {
"bookings": [
{
"booking_id": "VDBHS0xmMDBrUnJKRzV5MFcrYkdQUT09",
"booking_date": "2026-01-27",
"booking_code": "BK260127517586",
"payment_status": "PAID",
"total_amount": 800000,
"note": "Booking test",
"status": "TICKET_EXPORTED",
"created_at": 1769511555,
"is_grouped": false,
"customer": {
"name": "Thủy Phạm",
"phone": "0999999998",
"email": "customer@gmail.com",
"card_id": "033012239927"
},
"packages": [
{
"package_code": "B2C230",
"package_name": "PHÍ THẮNG CẢNH, VÉ ĐÒ",
"quantity": 2
},
{
"package_code": "B2C170",
"package_name": "PHÍ THẮNG CẢNH (ƯU TIÊN), VÉ ĐÒ",
"quantity": 2
}
],
"tickets": [
{
"code": "2037529996",
"service_name": "PHÍ THẮNG CẢNH, VÉ ĐÒ",
"use_from_date": "2026-01-27",
"use_to_date": "2026-02-06",
"package_code": "B2C230",
"e-invoice_code": "55bfea14-6d44-4a7d-8b36-f3faedce15c3",
"price": 230000,
"status": "WAITING",
"usage_limit": 1,
"sequence": 1
},
{
"code": "1064760083",
"service_name": "PHÍ THẮNG CẢNH, VÉ ĐÒ",
"use_from_date": "2026-01-27",
"use_to_date": "2026-02-06",
"package_code": "B2C230",
"e-invoice_code": "bc02c9da-0bd4-4bcf-b4b4-6dfb2208073a",
"price": 230000,
"status": "WAITING",
"usage_limit": 1,
"sequence": 2
},
{
"code": "2092671654",
"service_name": "PHÍ THẮNG CẢNH (ƯU TIÊN), VÉ ĐÒ",
"use_from_date": "2026-01-27",
"use_to_date": "2026-02-06",
"package_code": "B2C170",
"e-invoice_code": "c7a763ab-2637-4eb0-9e18-9d81241adbfb",
"price": 170000,
"status": "WAITING",
"usage_limit": 1,
"sequence": 3
},
{
"code": "1077920710",
"service_name": "PHÍ THẮNG CẢNH (ƯU TIÊN), VÉ ĐÒ",
"use_from_date": "2026-01-27",
"use_to_date": "2026-02-06",
"package_code": "B2C170",
"e-invoice_code": "beec1f33-b4af-4853-a66c-d83768b3db79",
"price": 170000,
"status": "WAITING",
"usage_limit": 1,
"sequence": 4
}
]
}
],
"pagination": {
"total": 179,
"per_page": 10,
"current_page": 1,
"last_page": 18,
"from": 1,
"to": 10
}
},
"message": "Success"
}