Chuyển tới nội dung chính

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ườngMô tảKiểu dữ liệu / Định dạng
from_dateNgày bắt đầuYYYY-MM-DD
to_dateNgày kết thúcYYYY-MM-DD
pageTrang hiện tạiint
per_pageSố lượng bản ghi trên mỗi trangint
date_filter_byLọ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ườngMô tảKiểu dữ liệu / Giá trị
bookingsDanh sách bookingarray
bookings[].booking_idID bookingstring
bookings[].booking_dateNgày BookingYYYY-MM-DD
bookings[].booking_codeMã bookingstring
bookings[].payment_statusTrạng thái thanh toánstring
bookings[].total_amountTổng tiềndouble
bookings[].noteGhi chústring
bookings[].statusTrạng thái bookingstring
bookings[].created_atThời gian tạo (Unix Timestamp)int
bookings[].is_groupedVé đoànbool
bookings[].customerThông tin khách hàngobject
bookings[].packagesThông tin gói bán trong bookingarray
bookings[].ticketsDanh sách vé (nếu booking đã xuất vé)array
bookings[].tickets[].priceGiá védouble
bookings[].tickets[].e-invoice_codeMã tra cứu hóa đơn điện tửstring
paginationThông tin phân trangobject
pagination.totalTổng số bản ghiint
pagination.per_pageSố bản ghi trên mỗi trangint
pagination.current_pageTrang hiện tạiint
pagination.last_pageTrang cuối cùngint

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"
}