> 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/rules.md).

# Rules

* **Idempotency by `requestId`** — re-sending the same `requestId` with the same `payload` within 10 minutes returns the original response; nothing is processed twice. When retrying after a timeout, keep the `requestId` and change only `timestamp`, then re-sign. Applies only to `price-check`, `bookings/create`, `bookings/commit`, `bookings/cancel`.
* **Idempotency by `partnerReference`** — `bookings/create` with a `partnerReference` that already has a booking returns that booking.
* **Timeout on `create` or `commit`** — do not create a new booking. Call `bookings/get` by `partnerReference` to learn the real state.
* **Concurrent commit** — if another `bookings/commit` for the same booking is running, Gotadi returns code `01` and does not charge twice. If Gotadi charged but a later step failed, the result is `09 PENDING`, **not an error**: do not refund the guest, re-check with `bookings/get`.
* **Pricing** — prices from `availability` and `offers` are cached indicative prices. The price is binding only at `price-check`; the guest pays exactly the booking's `totalAmount`. `price.total` covers the whole stay, all rooms, taxes included (`taxAndFees`). `totalBeforePromo` uses the same basis as `total` and exists only when `promo = true`.
* **Lifetimes** — `offerId` 30 minutes, `bookingToken` 15 minutes, payment before the `paymentDeadline` returned by `create`.
* **Limits** — `availability` accepts at most 50 `masterIds`, 30 nights, 8 rooms. Call rates follow the contract; exceeding them returns HTTP 429 from the gateway.
* **Content** — sync the whole catalogue by `countryCode` and `cursor` and store it on your side. **Do not call `content/properties` inside the guest search flow.**
* **Personal data** — guest names, emails and phone numbers are used for the booking only; never log them in clear text.
