Test Data

Everything you need to test your integration against the Booking Brain API.

API key

All requests require an API key issued by the Booking Brain team -- see Authentication for how to request one. Replace YOUR_API_KEY in the examples below with your key.

:::caution Live data There is no separate sandbox environment -- these examples run against live data. The read-only endpoints below are safe to call. Do not test the booking or payment endpoints without agreeing a test procedure with the Booking Brain team first: they create real bookings and charge real cards. :::

Base URL

https://app.bookingbrain.com/api/v1/developer

Example property IDs

These live properties have rich data suitable for testing the read-only endpoints:

Property ID	Name	Location	Bedrooms	Sleeps	Pets
3818	Apartment 5, The Albemarle	Ilfracombe	2	4	Yes
2095	Merrijig	Dulverton	3	6	No
3659	Gapperies	West Porlock	3	6	Yes

tip

Property data changes over time. Always use IDs taken from live search results (or the table above) rather than guessing.

Example places

Pass these as the property_place_slug query parameter on the search endpoint. The full list is available from GET /places.

Slug	Name
stay-in-porlock	Porlock
stay-in-dunster	Dunster
stay-in-lynton	Lynton
stay-in-exmoor	Exmoor (broad area)

Ready-to-use requests

Search properties

curl "https://app.bookingbrain.com/api/v1/developer/search?property_place_slug=stay-in-exmoor&guests=4" \
  -H "X-API-Key: YOUR_API_KEY"

Get property details

curl "https://app.bookingbrain.com/api/v1/developer/properties/3818" \
  -H "X-API-Key: YOUR_API_KEY"

Check unavailable dates

curl "https://app.bookingbrain.com/api/v1/developer/properties/3818/unavailableDates?year=2026&month=7" \
  -H "X-API-Key: YOUR_API_KEY"

Calculate price

curl -X POST "https://app.bookingbrain.com/api/v1/developer/properties/3818/get-price" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_date": "2026-08-01", "num_nights": 7, "num_guests": 4}'

List places

curl "https://app.bookingbrain.com/api/v1/developer/places" \
  -H "X-API-Key: YOUR_API_KEY"

Get property images

curl "https://app.bookingbrain.com/api/v1/developer/properties/3818/images" \
  -H "X-API-Key: YOUR_API_KEY"

Get property reviews

curl "https://app.bookingbrain.com/api/v1/developer/properties/3818/reviews?limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

Check usage stats

curl "https://app.bookingbrain.com/api/v1/developer/usage/stats?client_id=1&start_date=2026-03-01&end_date=2026-03-19" \
  -H "X-API-Key: YOUR_API_KEY"

Next steps

• Quick Start -- Make your first API call
• Booking Flow -- End-to-end integration guide
• Error Handling -- Handle errors and rate limits