The Book-ah API
Your Book-ah workspace already runs a booking site. The API lets your own website do the same: list your properties, show each room’s photos and prices, mark the nights that are full, and send booking requests that land in Book-ah beside the ones from your Book-ah site.
Everything the API returns comes from the same place as your Book-ah site, so a price, a minimum stay or a full night is always the same on both.
What you need
Section titled “What you need”- A Book-ah workspace on the Growth plan or above.
- An admin of the workspace, to create a key in Settings → Developers.
- Your website’s address, if the key will be used from its pages.
What you can do
Section titled “What you can do”| Endpoint | What it does |
|---|---|
GET /properties/ | List your properties |
GET /properties/{propertyId}/ | A property, its photos and rooms |
GET /properties/{propertyId}/availability/ | Nights a property is full |
POST /quotes/ | Price a room for a stay |
POST /booking-requests/ | Send a booking request |
GET /booking-requests/{bookingRequestId}/ | A booking request and its status |
Every answer has the same shape, described in Responses and errors. The API reference lists every field, and lets you try each call.
Where to start
Section titled “Where to start”- Your first call: create a key and list your properties.
- Keys and security: which key to use where.
- Show your rooms and prices, then take a booking request.