Built for people, readable by agents

AI assistants can search SaloonApp, read real prices and open times, and hold a booking for someone. The person always confirms with a code sent to their own phone, so no booking is ever made without them.

Discovery

OpenAPI 3.1: https://backend.saloonapp.lk/v1/agent/openapi.json
Site summary for language models: /llms.txt
Every salon page carries schema.org BeautySalon/HairSalon data with services, prices, hours and a ReserveAction.
WebMCP tools (search_salons, get_salon, get_availability, open_booking) register automatically in browsers that support navigator.modelContext.

1. Search

GET https://backend.saloonapp.lk/v1/agent/search?category=bridal&city=kandy

2. Check availability

GET https://backend.saloonapp.lk/v1/agent/salons/{slug}/availability?date=2026-12-12&serviceIds=svc_1,svc_2

3. Hold a booking

POST https://backend.saloonapp.lk/v1/agent/bookings
{
  "salonSlug": "kandy-bridal-house",
  "serviceIds": ["svc_1"],
  "date": "2026-12-12",
  "time": "06:30",
  "customerName": "Nadeesha Perera",
  "customerPhone": "0771234567",
  "agentName": "My Assistant"
}

The response is 202 awaiting_customer_confirmation. We text the person a 6-digit code. Holds are released after 15 minutes.

4. Confirm

POST https://backend.saloonapp.lk/v1/agent/bookings/{bookingId}/confirm
{ "code": "123456" }

If the salon needs a deposit, the response includes a PayHere link for the person to pay. Salons not on direct agent booking return a handoff_required link to finish on our site.

Fair use

Read endpoints allow 60 requests a minute per IP, and booking holds 10 an hour. Times are Asia/Colombo and prices are in LKR. Questions: [email protected].