API overview

Base URL

https://api.bewtee.com/api/v1

The API is JSON over HTTPS, authenticated with a secret API key, and scoped to the one business that owns the key.

Conventions

Envelope. Every response is { "status": boolean, "message": string, "data": ... }. Errors add error.code. See errors.
Dates and times. date is YYYY-MM-DD and time is 24-hour HH:MM, both in the business timezone (Asia/Kolkata). Timestamps such as starts_at are ISO 8601 with an offset.
Money. Booking amounts are whole rupees. currency is always INR.
IDs. Services, staff, customers and bookings use numeric IDs.
Lists. GET /bookings is paged with page and per_page (up to 100); meta.has_more says whether another page exists.
Additive changes. New fields can appear in responses without a version change. Ignore fields you do not recognise.

Method	Path	Purpose
`GET`	`/business`	The business profile and opening hours
`GET`	`/services`	Bookable services with prices and durations
`GET`	`/staff`	Staff members customers can book
`GET`	`/availability`	Free start times for a date and a set of services
`GET`	`/bookings`	List bookings
`POST`	`/bookings`	Create a booking
`GET`	`/bookings/{id}`	Fetch one booking
`POST`	`/bookings/{id}/cancel`	Cancel a booking

Payments. API bookings are always pay-at-salon. Online prepayment, packages, memberships, offers and loyalty points are available on the Bewtee page and in the widget's hand-off, not through this API.
Editing the catalogue. Services, prices, staff and hours are managed in the dashboard.
Rescheduling. Cancel and create a new booking, or move it in the dashboard.