Overview
The Kisum Venue Booking API lets a venue’s website show the venue’s spaces, packages and available dates, calculate prices, and send booking requests from visitors.
The venue manages its spaces, prices and bookings in Kisum Venues. Your website reads that information through the API and always shows the venue’s current data.
What you can build
Section titled “What you can build”- The venue’s description, photos and house rules.
- A list of the venue’s spaces with photos, capacity and layouts.
- The time slots and packages offered for each space, with prices before and after tax.
- An availability calendar.
- A price quote for a selected package, slot and date.
- A booking request form for visitors.
How booking works
Section titled “How booking works”- A visitor selects a space, a time slot, a package and a date on your website.
- Your website sends a booking request with the visitor’s contact details.
- The selected date is held and shown as unavailable while the venue reviews the request.
- The venue accepts or declines the request in Kisum Venues and contacts the visitor directly.
Two ways to build the booking page
Section titled “Two ways to build the booking page”One page for the whole venue. The key covers all the venue’s spaces. The page lists them and the visitor picks a space in the form.
One page per space. The venue creates one website key per space and limits each key to that space. The page asks for the space list, gets exactly one space back, and uses it for everything. The visitor never picks a space: they arrive on the page for the space they want, chosen in your website’s own menu.
Every request that needs a space still sends a spaceId. On a one-space page your code fills it in once, from the single space the key returns, so the form has no space field.
A booking request is not a confirmed booking, and no payment is taken through the API. Visitors do not need a Kisum account.
The API is available only while the venue is listed on the marketplace and has at least one published active space. Otherwise every request returns 404.
Base URL
Section titled “Base URL”https://api.kisum.io/venues/public/v1/sites/{siteKey}{siteKey} is the venue’s website key. See Getting started.