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.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
from | query | string | First day. YYYY-MM-DD, venue time (Europe/Athens). | |
to | query | string | Last day. YYYY-MM-DD, venue time (Europe/Athens). | |
class_type_id | query | string | Only 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.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
date | query | string | yes | The day. YYYY-MM-DD, venue time (Europe/Athens). |
service_id | query | string | Appointments: the service (required). | |
staff_id | query | string | Appointments: only with this person. | |
party | query | integer | Restaurants: 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.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
date | body | string | yes | The day. YYYY-MM-DD, venue time (Europe/Athens). |
time | body | string | yes | Start time HH:MM, as returned by /public/slots. |
service_id | body | string | Appointments: the service. | |
staff_id | body | string | Appointments: a specific person (optional). | |
party | body | integer | Restaurants: number of people. | |
name | body | string | yes | Guest’s full name. |
email | body | string | yes | Guest’s email: the confirmation and the link to view or cancel go here. |
phone | body | string | yes | Guest’s phone, international or local format. |
note | body | string | Optional note for the venue. | |
consent | body | boolean | yes | Must 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.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
check_in | query | string | yes | Arrival. YYYY-MM-DD, venue time (Europe/Athens). |
check_out | query | string | yes | Departure. YYYY-MM-DD, venue time (Europe/Athens). |
guests | query | integer | Number 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.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
unit_id | body | string | yes | From /public/availability. |
check_in | body | string | yes | Arrival. YYYY-MM-DD, venue time (Europe/Athens). |
check_out | body | string | yes | Departure. YYYY-MM-DD, venue time (Europe/Athens). |
guests | body | integer | yes | Number of guests. |
name | body | string | yes | Guest’s full name. |
email | body | string | yes | Guest’s email: the confirmation and the link to view or cancel go here. |
phone | body | string | yes | Guest’s phone, international or local format. |
note | body | string | Optional note for the venue. | |
consent | body | boolean | yes | Must 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=…"
}
}