API Reference

The public API uses clean, human-readable RESTful URLs with a consistent JSON envelope, so both browsers and AI agents can discover and call them.

Base URLs: customer endpoints are on https://theroyalglow.in (local: http://localhost:3000); the admin endpoint groups are a separate app on https://admin.theroyalglow.in (local: http://localhost:3001) with no /api/admin/ segment. Most endpoints require a Better Auth session cookie; public endpoints (services, availability, lead capture, health) need none. Every response — except GET /api/health — uses the shared { success, data } envelope.

Response shape

Tab Title
Tab Title

{ "success": true, "data": {}, "meta": {} }

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request data",
    "statusCode": 400,
    "requestId": "req_xxx"
  }
}

Endpoint groups

Key endpoints (quick index)

Action	Method	Path
List services	GET	`/api/services`
Check availability	GET	`/api/availability?date={YYYY-MM-DD}&branchId={id}`
Submit booking request	POST	`/api/bookings`
Get booking status	GET	`/api/bookings/{id}`
Submit campaign lead	POST	`/api/leads`
Health check	GET	`/api/health`

AI-discovery files

A complete, auto-generated reference (via fumadocs-openapi from a published OpenAPI spec) is a planned follow-up. This page documents the stable, agent-facing surface in the meantime.

Last modified on June 29, 2026

Overview

Product

Features

Engineering

System design

Engineering standards

API reference

Application surface

Platform

Quality & security

Operations

Reference

API Reference

API Reference

Response shape

Endpoint groups

Key endpoints (quick index)

AI-discovery files

​API Reference

​Response shape

​Endpoint groups

​Key endpoints (quick index)

​AI-discovery files

API Reference

Response shape

Endpoint groups

Key endpoints (quick index)

AI-discovery files