> 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-price-check.md).

# API Price Check

Endpoint: `price-check`

Lock the price of one `offerId` and obtain a `bookingToken`.

**Request**

| Field     | Type   | Required |
| --------- | ------ | -------- |
| `offerId` | string | ✔        |

```json
{ "offerId": "of_8Jk2..." }
```

**Response (`00`)**

| Field              | Type      | Description                                 |
| ------------------ | --------- | ------------------------------------------- |
| `bookingToken`     | string    | Opaque string, **expires after 15 minutes** |
| `price`            | `Money`   | The locked price                            |
| `cancelPolicies[]` | array     | The **binding** schedule for the booking    |
| `expiresAt`        | date-time |                                             |

```json
{
  "bookingToken": "bt_Qw9x...",
  "price": { "total": 2400000, "perNight": 1200000, "currency": "VND", "taxIncluded": true },
  "cancelPolicies": [{ "from": "2026-11-18T12:00:00+07:00", "penaltyAmount": 1200000 }],
  "expiresAt": "2026-11-15T15:15:00+07:00"
}
```

{% hint style="warning" %}
**Price changed: code `20 PRICE_CHANGED`** — `payload` has the same `PriceCheckResponse` shape with a new `price` and a new `bookingToken`. Re-confirm with the guest; if they accept, use the new token. **Sold out: code `21 SOLD_OUT`.**
{% endhint %}
