---
title: "Guides"
description: "How the Partner API works: the booking flow, conventions, reliability and keeping your data in sync."
url: "https://portal.konghotels.cloud/guides"
image: "https://portal.konghotels.cloud/_og/d/c_Ocean.takumi,title_Guides,description_~SG93IHRoZSBQYXJ0bmVyIEFQSSB3b3JrczogdGhlIGJvb2tpbmcgZmxvdywgY29udmVudGlvbnMsIHJlbGlhYmlsaXR5IGFuZCBrZWVwaW5nIHlvdXIgZGF0YSBpbiBzeW5jLg,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMwRTJBMUYifX19,p_Ii9ndWlkZXMi,s_z4vek_SNIwAXaVOQ.png"
---

# Guides

The concepts behind the Partner API, from your first quote to a production-grade sync. Each guide takes about five minutes.

## [Build a booking](#build-a-booking)

[

### Booking flow

Search, quote, hold and book, then modify or cancel. Plus how all-in pricing works.





](https://portal.konghotels.cloud/guides/booking-flow)[

### Money, dates & times

Decimal-string amounts, property-local stay dates and ISO 8601 timestamps.





](https://portal.konghotels.cloud/guides/money-dates-times)[

### Idempotency

Retry bookings safely with an `Idempotency-Key`, without ever double-booking a guest.





](https://portal.konghotels.cloud/guides/idempotency)

## [Run in production](#run-in-production)

[

### Staying in sync

Poll the change feed or subscribe to signed webhooks, and refetch only what changed.





](https://portal.konghotels.cloud/guides/staying-in-sync)[

### Rate limits

Read, search and write buckets, the headers that track them, and how to back off.





](https://portal.konghotels.cloud/guides/rate-limits)[

### Errors

RFC 9457 problem details and every problem `type` the API returns.





](https://portal.konghotels.cloud/guides/errors)[

### Pagination

Cursor pagination for list endpoints.





](https://portal.konghotels.cloud/guides/pagination)[

### Test data

Seeded hotels, loyalty members, promotions and demo reservations.





](https://portal.konghotels.cloud/guides/test-data)