Your first call
-
Create a key. In Book-ah, open Settings → Developers and choose Create key. Pick Secret to follow this page from your own computer. Copy the key when it is shown: it is shown only once.
-
List your properties. From a terminal:
Terminal window curl https://app.book-ah.com/api/partner/v1/properties/ \-H "Authorization: Bearer sk_live_YOUR_KEY" -
Read the answer. Every answer is the same envelope. Your properties are in
data.items:{"isSuccess": true,"errorCode": 0,"message": "OK","data": {"items": [{"id": "01a1c414-7811-77cb-8966-c09cb9fdf1d9","slug": "villa-sayuri","name": "Villa Sayuri","nightlyRate": {"amount": "120.00","currency": "USD","rateUnit": "room","boardType": "BB","boardPrices": []}}]}} -
Open a property. Use an
idfrom the list, with dates to see prices for a stay:Terminal window curl "https://app.book-ah.com/api/partner/v1/properties/PROPERTY_ID/?checkIn=2026-12-20&checkOut=2026-12-23&adults=2" \-H "Authorization: Bearer sk_live_YOUR_KEY"
Every path ends in /. Without it you get a redirect, which most HTTP
clients do not follow for POST.
- Use the API from your website’s pages with a publishable key.
- Show your rooms and prices.