> For the complete documentation index, see [llms.txt](https://developer.gotadi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.gotadi.com/vietnamese/doi-tac-b2b2c/phuong-thuc-api/hotel/api/api-booking-detail.md).

# API Booking Detail

Endpoint: `bookings/get`

Tra cứu booking theo `bookingNumber` **hoặc** `partnerReference`.

```json
{ "partnerReference": "ORDER-20261115-0001" }
```

```json
{ "bookingNumber": "HTL2611150001" }
```

**Response**

| Field                                                 | Kiểu   | Mô tả                                                                       |
| ----------------------------------------------------- | ------ | --------------------------------------------------------------------------- |
| `bookingNumber`, `partnerReference`                   | string |                                                                             |
| `status`                                              | enum   | `PENDING_PAYMENT`, `CONFIRMED`, `PENDING`, `FAILED`, `CANCELLED`, `EXPIRED` |
| `hotelConfirmationCode`                               | string |                                                                             |
| `masterId`                                            | string |                                                                             |
| `hotelName`                                           | string | **Có thể không có** — lấy tên từ danh mục content theo `masterId`           |
| `paymentDeadline`, `checkin`, `checkout`, `createdAt` |        |                                                                             |
| `rooms[]`                                             | array  | `{ roomName, mealPlan, guests[] }`                                          |
| `totalAmount`, `currency`                             |        |                                                                             |
| `cancelPolicies[]`                                    | array  | `{ from, penaltyAmount }`                                                   |

```json
{
  "bookingNumber": "HTL2611150001",
  "partnerReference": "ORDER-20261115-0001",
  "status": "CONFIRMED",
  "hotelConfirmationCode": "DN-55821",
  "masterId": "30715",
  "checkin": "2026-11-20",
  "checkout": "2026-11-22",
  "rooms": [{
    "roomName": "Deluxe hướng biển",
    "mealPlan": "BREAKFAST",
    "guests": [{ "firstName": "An", "lastName": "Nguyen", "type": "ADULT" }]
  }],
  "totalAmount": 2400000,
  "currency": "VND",
  "cancelPolicies": [{ "from": "2026-11-18T12:00:00+07:00", "penaltyAmount": 1200000 }],
  "paymentDeadline": "2026-11-15T15:20:00+07:00",
  "createdAt": "2026-11-15T15:05:00+07:00"
}
```
