Skip to content

Your first call

  1. 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.

  2. 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"
  3. 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": []
    }
    }
    ]
    }
    }
  4. Open a property. Use an id from 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.