Developers · Guides
Build an appointment or table booking flow
Let customers book a service or a table from your own site or app, as guests, in three calls.
Salons, barbers, trainers and tutors take appointments; restaurants and bars take tables. Both are booked as guests: no account needed.
Appointments
GET /public/services name, minutes, price_eur, staff_ids
GET /public/staff optional: let them choose a person
GET /public/slots?date=2026-12-03&service_id=…[&staff_id=…]
POST /public/appointments
{
"date": "2026-12-03", "time": "18:30", "service_id": "…", "staff_id": "…",
"name": "Maria Papadopoulou", "email": "maria@example.com", "phone": "+30 691 234 5678",
"note": "First visit", "consent": true
}
The slots respect the venue’s hours, each person’s hours and services, blocked time, how soon and how far ahead it takes
bookings, and what is already booked. Without staff_id, Bookare picks a free person who does that service.
Tables
GET /public/slots?date=2026-12-03&party=4
POST /public/appointments { "date", "time", "party": 4, "name", "email", "phone", "consent": true }
Bookare gives the smallest free table that fits the party. party is limited by the venue’s largest online party.
Answers
201 with code, status (confirmed, or requested if the venue confirms by hand), starts_at, ends_at and
manage_url: the link where the guest views or cancels. The guest also gets it by email.
| Answer | Reason | What to do |
|---|---|---|
409, reason: "gone" |
Someone took that time a moment ago | Reload the slots |
429, reason: "limit" |
Too many bookings from this IP or email | Ask them to try later or call |
422, reason: "month" |
The venue’s plan reached its monthly online bookings | Ask them to call |
422 with field |
Name, email, phone or consent | Show the message by the field |
Consent
consent: true means the guest accepted the venue’s terms and privacy notice. Show a checkbox and only send true if ticked.
Customers who come back
If you want a “my bookings” page, sign them in (authentication) and call GET /me/appointments.