Skip to main content

Booking Brain Developer API

The Booking Brain Developer API gives you full programmatic access to holiday rental property search, availability, pricing, booking, and payment processing. Everything you need to build a custom booking experience on top of the Booking Brain platform.

What is Booking Brain?​

Booking Brain is a holiday property management platform used by property owners and letting agencies to manage their rental portfolios. The platform handles property listings, availability calendars, pricing rules, guest bookings, payment processing, and guest reviews.

The Developer API opens all of this up to you. Instead of using the default Booking Brain website, you can build your own frontend -- a bespoke website, a mobile app, a chatbot, or an AI agent -- and let Booking Brain handle the backend.

What can you build?​

Use caseEndpoints you'll need
Custom property websiteSearch, Property Details, Images, Availability, Pricing
Booking widgetAvailability, Pricing, Booking, Payment
Destination landing pagePlaces, Search, Property Details
AI booking assistantAll endpoints via function calling
Price comparison feedSearch, Pricing, Special Offers
Availability calendarUnavailable Dates, Start Days, Start Dates, Short Breaks
Mobile appFull API surface

API at a glance​

Base URLhttps://app.bookingbrain.com/api/v1/developer
AuthenticationX-API-Key header
FormatJSON
VersioningURL-based (/api/v1)
Rate limitingPer-minute, per-client
Endpoints22 across 7 groups

Endpoint groups​

  • Property Search -- Search properties by location, dates, guests, and amenities. Browse special offers.
  • Property Details -- Full property information including images, reviews, extras, bedrooms, and owner contact.
  • Availability & Pricing -- Check calendar availability, valid start days, short break rules, and calculate accurate pricing.
  • Booking -- Submit bookings and validate discount vouchers.
  • Payment -- Process card payments via the SagePay/Opayo gateway.
  • Places -- Browse destination areas and retrieve properties by location.
  • Usage -- Monitor your API consumption with usage statistics and detailed request logs.

Quick example​

Search for pet-friendly cottages in Exmoor:

curl "https://app.bookingbrain.com/api/v1/developer/search?property_place_slug=stay-in-exmoor&guests=4&no_of_dogs=1" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "properties": [
    {
      "id": 3659,
      "title": "Gapperies, West Porlock",
      "slug": "gapperies",
      "property_place_slug": "stay-in-porlock-weir",
      "bed_rooms": 3,
      "total_guest": 6,
      "is_pets": true,
      "min_price": 595.00,
      "rating": 4.7,
      "thumbnailUrl": "https://storage.googleapis.com/bb-property-images/properties/3659/gapperies-main.jpg",
      "search_summary": "A charming thatched cottage with stunning views across Porlock Vale to the Bristol Channel."
    }
  ],
  "total_property_on_search": 74,
  "current_page": 1,
  "num_pages": 4,
  "perpage": 20
}

Typical booking flow​

The API is designed around a natural booking journey:

Search --> Select property --> Check availability --> Calculate price --> Book --> Pay
  1. Search -- GET /developer/search to find properties matching the guest's criteria
  2. Detail -- GET /developer/properties/{id} to load the full listing
  3. Availability -- GET /developer/properties/{id}/unavailableDates to show which dates are free
  4. Price -- POST /developer/properties/{id}/get-price to calculate the exact cost
  5. Book -- POST /developer/bookings/save to create the reservation
  6. Pay -- POST /developer/bookings/processPayment to charge the guest's card

See the Booking Flow Guide for a complete walkthrough with code examples.

Who is this for?​

  • Web agencies building custom property websites for holiday letting businesses
  • Property owners who want a bespoke booking experience on their own domain
  • AI developers building booking assistants, chatbots, or automated agents
  • Aggregators pulling property data into comparison or marketplace platforms

Getting access​

Every request requires an API key issued by the Booking Brain team. To request one, contact support@bookingbrain.co.uk with your company name, a description of your integration, and the IP addresses your servers will call from. See Authentication for full details.

Once you have your key, add it to every request in the X-API-Key header and you're ready to go.

Next steps​