Getting started

1. Get a website key

The venue creates the website key in Kisum Venues:

1. Go to Settings > Website booking.
2. Select New website key.
3. Enter a name, list the websites allowed to use the key (one per line, for example thestage.com and www.thestage.com), and select the date hold period.
4. Select Create key and copy the key. It starts with kvw_.

The key is shown only once. If it is lost, the venue disables it and creates a new one.

The website key identifies the venue. It is not a password: it is visible in your website’s requests, and it only works from the websites listed on it.

2. Make your first request

Replace kvw_yourKey with the website key:

curl https://api.kisum.io/venues/public/v1/sites/kvw_yourKey/venue

A successful response looks like this:

{
  "success": true,
  "message": "ok",
  "data": {
    "name": "The Stage",
    "city": "Denpasar",
    "country": "Indonesia",
    "currency": "IDR",
    "timezone": "Asia/Makassar",
    "media": []
  }
}

Every successful response has success: true and the result in data. Errors are described in Rules and limits.

The venue details are available only while the venue’s public listing is published in Kisum Venues. Otherwise the API returns 404.

3. Call the API from your website

Requests from a browser are accepted only from the websites listed on the website key. During development, ask the venue to add your local address, for example http://localhost:3000, and to remove it before going live.

No other headers or authentication are required.

Next step

Follow the booking flow.