B Bookare Helpbookare.app →

Developers · Start here

Quickstart

Your first calls to the Bookare API in five minutes, with curl.

You need a venue on Bookare. Any plan works, including the free plan and the trial. Replace yourvenue with the venue’s address name.

1. Read something public

No key needed:

curl https://yourvenue.bookare.app/api/v1/public/venue
{
  "data": {
    "name": "Move Studio",
    "booking_mode": "classes",
    "address": "Kifisias 120, Marousi 151 25",
    "languages": ["el", "en"],
    "currency": "EUR",
    "timezone": "Europe/Athens",
    "booking_page": "https://yourvenue.bookare.app"
  }
}

For a gym or studio, the next 7 days of classes with free spots:

curl "https://yourvenue.bookare.app/api/v1/public/classes"

2. Get an API key

In the venue’s admin: Settings → Assistant and API → API key (advanced). Name it, choose Read only for now, and copy the key (bkp_...). It is shown once.

export BOOKARE_KEY=bkp_...
curl https://yourvenue.bookare.app/api/v1/admin/venue -H "Authorization: Bearer $BOOKARE_KEY"

3. Search members

curl "https://yourvenue.bookare.app/api/v1/admin/members?search=maria" -H "Authorization: Bearer $BOOKARE_KEY"

4. Make a change

Create a key with Read and change, then:

curl -X POST https://yourvenue.bookare.app/api/v1/admin/packs \
  -H "Authorization: Bearer $BOOKARE_KEY" -H "Content-Type: application/json" \
  -d '{"name":"10 classes","classes":10,"valid_days":60,"price_eur":95}'

201 Created with the new pack. It is on sale to members straight away.

5. Sign a customer in

curl -X POST https://yourvenue.bookare.app/api/v1/auth/code -H "Content-Type: application/json" -d '{"email":"maria@example.com"}'
# → {"data":{"challenge":"...","expires_in":600}}   Maria gets a 6-digit code by email
curl -X POST https://yourvenue.bookare.app/api/v1/auth/token -H "Content-Type: application/json" \
  -d '{"email":"maria@example.com","code":"482913","challenge":"..."}'
# → {"data":{"token":"...","token_type":"Bearer","expires_in":7776000,"customer":{...}}}
curl https://yourvenue.bookare.app/api/v1/me/packs -H "Authorization: Bearer <token>"

Next