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>"