Public API (read-only)

Public read-only API for AI agents and integrations

Retrieve information from 予約Lite shop pages (menus, prices, and available slots). No authentication is required. Bookings cannot be confirmed via the API. Please direct customers to the shop's booking page https://yoyakulite.com/book/{slug} instead.

OpenAPI 3.1: https://yoyakulite.com/openapi.json
API catalog (RFC 9727): https://yoyakulite.com/.well-known/api-catalog
All times are in ISO 8601 (UTC). The shop's time zone (e.g., Asia/Tokyo) is also returned. Prices include tax (JPY).

`GET /api/stores/{slug}`

Returns the shop name, booking availability status, cancellation deadline, and bookable menus (duration, tax-inclusive price, and options).slug is the last segment of the booking page URL.

curl https://yoyakulite.com/api/stores/demo-salon

`GET /api/availability/month?slug=&serviceId=&month=YYYY-MM`

Returns the number of available slots per day for the specified menu. To add options, specify options=id1,id2(availability changes because the duration increases).

curl "https://yoyakulite.com/api/availability/month?slug=demo-salon&serviceId=<services[].id>&month=2026-10"

`GET /api/availability?slug=&serviceId=&date=YYYY-MM-DD`

Returns the bookable start times (slotson the specified date. When bookings are suspended, error: "paused" is included.

curl "https://yoyakulite.com/api/availability?slug=demo-salon&serviceId=<services[].id>&date=2026-10-01"

`GET /api/version`

Running version (health check).

curl https://yoyakulite.com/api/version

Errors

400 bad_request(missing parameters or invalid format),400 unknown_option、404 not_found(shop not found),404 service_not_found. This text is {"error": "..."} .

About Usage

店舗様の営業を妨げる大量アクセスはお控えください。予約の代行・自動確定には対応していません。お問い合わせは特定商取引法に基づく表記の連絡先まで。