B Bookare Helpbookare.app →

Developers · Reference

Public API

Endpoints that need no key, showing what the venue offers publicly, plus guest bookings for appointments, tables and stays.

All paths are relative to https://{venue}.bookare.app/api/v1. Answers are { "data": … }; errors are described in Errors, dates, languages and limits. The same reference is available as OpenAPI.

Public

GET/public/venue

The venue: name, contact details, hours, languages, how it takes bookings · Auth: None · getPublicVenue

{
  "data": {
    "name": "Move Studio",
    "booking_mode": "classes",
    "currency": "EUR",
    "timezone": "Europe/Athens"
  }
}

GET/public/class-types

Kinds of class · Auth: None · getPublicClassTypes

Kinds of class

Available for gyms and studios.

GET/public/classes

Classes on the calendar with free spots · Auth: None · getPublicClasses

Scheduled classes between two dates (at most 31 days; default: today and the next 7 days). Drop-in types (no set times) are not listed. Members book with POST /me/bookings.

Available for gyms and studios.

FieldInTypeRequiredDescription
fromquerystringFirst day. YYYY-MM-DD, venue time (Europe/Athens).
toquerystringLast day. YYYY-MM-DD, venue time (Europe/Athens).
class_type_idquerystringOnly this kind of class.
{
  "data": [
    {
      "id": "tpl1:2026-12-01",
      "class_type_id": "ct1",
      "class_type": "Pilates Reformer",
      "date": "2026-12-01",
      "time": "18:00",
      "starts_at": "2026-12-01T16:00:00.000Z",
      "minutes": 50,
      "spots": 6,
      "spots_left": 2,
      "instructor": "Eleni",
      "off_peak": false
    }
  ]
}

GET/public/packs

Packs for sale · Auth: None · getPublicPacks

Packs anyone can buy, with prices. Members buy with POST /me/packs; special packs for chosen members appear in GET /me/packs/available.

Available for gyms and studios.

GET/public/services

Services that can be booked, with duration and price · Auth: None · getPublicServices

Services that can be booked, with duration and price

Available for venues with appointments.

GET/public/staff

Staff customers can choose · Auth: None · getPublicStaff

Staff customers can choose

Available for venues with appointments.

GET/public/slots

Free times on a day · Auth: None · getPublicSlots

Appointments: pass service_id (and optionally staff_id). Restaurants: pass party. Times respect opening hours, how soon and how far ahead the venue takes bookings, and what is already booked.

Available for venues with appointments, restaurants and bars.

FieldInTypeRequiredDescription
datequerystringyesThe day. YYYY-MM-DD, venue time (Europe/Athens).
service_idquerystringAppointments: the service (required).
staff_idquerystringAppointments: only with this person.
partyqueryintegerRestaurants: number of people (default 2).
{
  "data": [
    {
      "time": "18:30",
      "starts_at": "2026-12-01T16:30:00.000Z",
      "ends_at": "2026-12-01T17:15:00.000Z"
    }
  ]
}

POST/public/appointments

Book an appointment or a table as a guest · Auth: None · postPublicAppointments

Books a free time from GET /public/slots. The guest gets a confirmation email with a link to view or cancel. Limited to 10 bookings an hour per IP and 5 per email. If the venue confirms by hand, status is "requested" until it does.

Available for venues with appointments, restaurants and bars.

FieldInTypeRequiredDescription
datebodystringyesThe day. YYYY-MM-DD, venue time (Europe/Athens).
timebodystringyesStart time HH:MM, as returned by /public/slots.
service_idbodystringAppointments: the service.
staff_idbodystringAppointments: a specific person (optional).
partybodyintegerRestaurants: number of people.
namebodystringyesGuest’s full name.
emailbodystringyesGuest’s email: the confirmation and the link to view or cancel go here.
phonebodystringyesGuest’s phone, international or local format.
notebodystringOptional note for the venue.
consentbodybooleanyesMust be true: the guest accepted the venue’s terms and privacy notice (show them a checkbox).
{
  "data": {
    "code": "AP-7K2QF",
    "status": "confirmed",
    "date": "2026-12-01",
    "time": "18:30",
    "manage_url": "https://studio.bookare.app/book/b/AP-7K2QF?k=…"
  }
}

GET/public/units

Rooms, homes, pitches and other units · Auth: None · getPublicUnits

Rooms, homes, pitches and other units

Available for stays.

GET/public/availability

Free units and total prices for dates · Auth: None · getPublicAvailability

Free units and total prices for dates

Available for stays.

FieldInTypeRequiredDescription
check_inquerystringyesArrival. YYYY-MM-DD, venue time (Europe/Athens).
check_outquerystringyesDeparture. YYYY-MM-DD, venue time (Europe/Athens).
guestsqueryintegerNumber of guests (default 2).
{
  "data": [
    {
      "unit_id": "u1",
      "name": "Double room",
      "available": true,
      "free": 2,
      "nights": 3,
      "total_eur": 210,
      "per_night": [
        {
          "date": "2026-07-01",
          "eur": 70
        }
      ]
    }
  ]
}

POST/public/stay-bookings

Book a stay as a guest · Auth: None · postPublicStayBookings

Books a unit for the dates. The guest gets a confirmation email with a link to view, pay (if the venue takes cards) or cancel. Limited to 10 bookings an hour per IP and 5 per email.

Available for stays.

FieldInTypeRequiredDescription
unit_idbodystringyesFrom /public/availability.
check_inbodystringyesArrival. YYYY-MM-DD, venue time (Europe/Athens).
check_outbodystringyesDeparture. YYYY-MM-DD, venue time (Europe/Athens).
guestsbodyintegeryesNumber of guests.
namebodystringyesGuest’s full name.
emailbodystringyesGuest’s email: the confirmation and the link to view or cancel go here.
phonebodystringyesGuest’s phone, international or local format.
notebodystringOptional note for the venue.
consentbodybooleanyesMust be true: the guest accepted the venue’s terms and privacy notice (show them a checkbox).
{
  "data": {
    "code": "BK-7K2QF4",
    "status": "confirmed",
    "total_eur": 210,
    "manage_url": "https://rooms.bookare.app/stay/b/BK-7K2QF4?k=…"
  }
}