> 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/english/b2b2c-partner/api-method/hotel-1/api/api-booking-create.md).

# API Booking Create

Endpoint: `bookings/create`

Create a booking awaiting payment.

**Request**

| Field                                   | Type        | Required | Description                                                                       |
| --------------------------------------- | ----------- | -------- | --------------------------------------------------------------------------------- |
| `bookingToken`                          | string      | ✔        | From `price-check`                                                                |
| `partnerReference`                      | string ≤ 64 | ✔        | Partner order id, unique; re-sending returns the existing booking                 |
| `contact.firstName`, `contact.lastName` | string      | ✔        |                                                                                   |
| `contact.email`                         | email       | ✔        |                                                                                   |
| `contact.phone`                         | string      | ✔        | Domestic number (`0901234567`) or with country code (`+84901234567`)              |
| `contact.phoneCode`                     | string      |          | Country code, with or without `+`; default `84`. **Required for foreign numbers** |
| `rooms[].guests[]`                      | array       | ✔        | `{ firstName, lastName, type: ADULT\|CHILD, age }`                                |
| `specialRequest`                        | string      |          |                                                                                   |

{% hint style="danger" %}
Guests follow the **exact `rooms` order used in search**: each room must carry exactly the `ADULT` count and the `CHILD` entries (with `age`) that were searched. A mismatch returns code `07`.
{% endhint %}

```json
{
  "bookingToken": "bt_Qw9x...",
  "partnerReference": "ORDER-20261115-0001",
  "contact": {
    "firstName": "An", "lastName": "Nguyen",
    "email": "an.nguyen@example.com",
    "phone": "0901234567", "phoneCode": "84"
  },
  "rooms": [{
    "guests": [
      { "firstName": "An", "lastName": "Nguyen", "type": "ADULT" },
      { "firstName": "Binh", "lastName": "Tran", "type": "ADULT" },
      { "firstName": "Minh", "lastName": "Nguyen", "type": "CHILD", "age": 6 }
    ]
  }],
  "specialRequest": "High floor"
}
```

**Response**

| Field                     | Type      | Description                                |
| ------------------------- | --------- | ------------------------------------------ |
| `bookingNumber`           | string    | Gotadi-side booking id                     |
| `partnerReference`        | string    |                                            |
| `status`                  | enum      | `PENDING_PAYMENT`                          |
| `totalAmount`, `currency` |           | Amount to collect from the guest           |
| `paymentDeadline`         | date-time | Room-hold deadline, typically \~10 minutes |

```json
{
  "bookingNumber": "HTL2611150001",
  "partnerReference": "ORDER-20261115-0001",
  "status": "PENDING_PAYMENT",
  "totalAmount": 2400000,
  "currency": "VND",
  "paymentDeadline": "2026-11-15T15:20:00+07:00"
}
```

Collect payment from the guest, then call `bookings/commit` **before `paymentDeadline`**. Past the deadline the booking moves to `EXPIRED`.
