> 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-hotel-offers.md).

# API Hotel Offers

Endpoint: `offers`

All rooms and rate plans of one hotel.

**Request**

| Field                 | Type   | Required | Description                          |
| --------------------- | ------ | -------- | ------------------------------------ |
| `masterId`            | string | ✔        |                                      |
| `checkin`, `checkout` | date   | ✔        |                                      |
| `rooms[]`             | array  | ✔        | 1–8 rooms, `{ adults, childAges[] }` |
| `language`            | enum   |          | `vi` \| `en`                         |

```json
{
  "masterId": "30715",
  "checkin": "2026-11-20",
  "checkout": "2026-11-22",
  "rooms": [{ "adults": 2, "childAges": [6] }],
  "language": "en"
}
```

**Response**

| Field                                    | Type      | Description                                                                      |
| ---------------------------------------- | --------- | -------------------------------------------------------------------------------- |
| `offerId`                                | string    | Opaque string, **expires after 30 minutes** (`expiresAt`)                        |
| `roomTypeId`, `roomName`, `ratePlanName` | string    |                                                                                  |
| `mealPlan`                               | enum      | `ROOM_ONLY`, `BREAKFAST`, `HALF_BOARD`, `FULL_BOARD`, `ALL_INCLUSIVE`            |
| `breakfastIncluded`                      | boolean   |                                                                                  |
| `bedTypes[]`                             | string\[] |                                                                                  |
| `amenities[]`                            | string\[] | Rate-plan amenities                                                              |
| `price`                                  | `Money`   | `total`, `perNight`, `currency`, `taxIncluded`, `taxAndFees`, `totalBeforePromo` |
| `promo`                                  | boolean   |                                                                                  |
| `refundable`                             | boolean   |                                                                                  |
| `freeCancellationUntil`                  | date-time | Free-cancellation deadline; absent when `refundable: false`                      |
| `cancelPolicies[]`                       | array     | `{ from, penaltyAmount }` — the **search-time** version                          |
| `remainingRooms`                         | int       |                                                                                  |
| `expiresAt`                              | date-time |                                                                                  |

```json
{
  "masterId": "30715",
  "offers": [{
    "offerId": "of_8Jk2...",
    "roomTypeId": "DLX",
    "roomName": "Deluxe Ocean View",
    "ratePlanName": "Breakfast included, free cancellation",
    "mealPlan": "BREAKFAST",
    "breakfastIncluded": true,
    "bedTypes": ["1 double bed"],
    "amenities": ["Buffet breakfast", "Upgrade if available"],
    "price": {
      "total": 2400000, "perNight": 1200000, "currency": "VND",
      "taxIncluded": true, "taxAndFees": 283600, "totalBeforePromo": 2700000
    },
    "promo": true,
    "refundable": true,
    "freeCancellationUntil": "2026-11-18T12:00:00+07:00",
    "cancelPolicies": [{ "from": "2026-11-18T12:00:00+07:00", "penaltyAmount": 1200000 }],
    "remainingRooms": 3,
    "expiresAt": "2026-11-15T15:30:00+07:00"
  }]
}
```

{% hint style="info" %}
The **first** call for a given `masterId`/date/occupancy set may take up to **\~6 seconds** because Gotadi resolves the hotel first; subsequent calls within 30 minutes are faster.
{% endhint %}

`cancelPolicies` here is the search-time version; the **binding** one for the booking comes from `price-check`. `penaltyAmount` is already converted from an amount, a percentage of the total, or a number of nights.
