B Bookare Helpbookare.app →

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: 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.