Skip to content
Book-ah API

Changelog

Partner API changelog

/api/partner/v1, the API a workspace’s own website calls with its API key. Newest first. Within v1 we only add (see ../standard.md). docs.book-ah.com publishes this file and openapi.json beside it.

2026-11-10: booking requests

  • POST /booking-requests/: asks the property for a room, held to the same rules and prices as its Book-ah site, and emailed to the guest and the team. It holds no room: the request is pending until the property answers. Send Idempotency-Key and a retry returns the first answer (200) instead of a second request; the same key with a different body is 4001.
  • GET /booking-requests/{bookingRequestId}/: its status, secret key only.

2026-11-10: first release

  • Keys from Settings → Developers: publishable (pk_live_…, for web pages, limited to the website addresses on the key) and secret (sk_live_…, for servers, refused from a browser). Sent as Authorization: Bearer <key>.
  • GET /properties/: the workspace’s active properties, with “from” prices.
  • GET /properties/{propertyId}/: photos and rooms; with checkIn and checkOut, every room carries an offer for that stay.
  • GET /properties/{propertyId}/availability/?from&to: the nights with no room free, for a date picker.
  • POST /quotes/: one room’s price for a stay, on every board it sells.
  • Limits: 600 calls a minute per key, and 120 a minute per visitor on a publishable key. Over a limit is 429 with 5001 and Retry-After.