AI Booking API • V8.4.1
Book a Khmer-English medical interpreter from an AI assistant.
The same live booking engine used by this website is available to authorized AI assistants. AI clients can read services, check current availability, offer nearby alternatives, create a private prepaid temporary reservation after explicit user confirmation, return a Stripe payment link, and verify the final status of that AI-created booking.
Machine interfaces
Connection endpoints
OpenAPI:https://khmermedicalinterpreter.com/openapi.json
MCP:https://khmermedicalinterpreter.com/mcp
Timezone:America/Phoenix
Authentication:
Bearer API key for booking writes and booking-status access. AI booking is private/prepaid only; organization invoice workflows remain separate.
Designed for conversational booking
Recommended AI flow
1. Understand the service
Read the service catalog and current server-calculated pricing. No personal information is needed.
Read the service catalog and current server-calculated pricing. No personal information is needed.
2. Check the requested slot
Ask the live availability endpoint. If the requested time is unavailable, offer the returned alternatives.
Ask the live availability endpoint. If the requested time is unavailable, offer the returned alternatives.
3. Ask the user to confirm
The AI should state the exact service, date, Arizona time, duration, and price, then ask whether the user wants it booked.
The AI should state the exact service, date, Arizona time, duration, and price, then ask whether the user wants it booked.
4. Create a real hold only after “Yes”
The booking API rechecks availability and price. Private clients receive a Stripe Checkout URL and the appointment is temporarily held.
The booking API rechecks availability and price. Private clients receive a Stripe Checkout URL and the appointment is temporarily held.
5. Show the payment link
The AI displays the returned Stripe Checkout URL. The same link is emailed to the client and an unpaid hold expires according to the service policy.
The AI displays the returned Stripe Checkout URL. The same link is emailed to the client and an unpaid hold expires according to the service policy.
6. Verify confirmation
After payment, the AI can check booking status. Stripe webhooks, confirmation emails, owner alerts, and Google Calendar continue to use the existing production workflow.
After payment, the AI can check booking status. Stripe webhooks, confirmation emails, owner alerts, and Google Calendar continue to use the existing production workflow.
REST endpoints
| Operation | Endpoint |
|---|---|
| Services | GET /api/ai/services |
| Availability | GET /api/ai/availability |
| Create hold | POST /api/ai/bookings/hold |
| Booking status | GET /api/ai/bookings/status |
Example conversation
User: I need a Khmer-English interpreter Wednesday at 9 AM for one hour by phone.\n\nAI: I can check live OPI availability.\n\n[checks API]\n\nAI: 9:00–10:00 AM Arizona time is available. The total is $75. Would you like me to reserve it?\n\nUser: Yes.\n\n[creates hold]\n\nAI: Your time is temporarily reserved. Complete the $75 secure Stripe payment here: [checkout link]
Privacy rule for AI clients: booking tools are for scheduling and contact details only. Do not request or transmit diagnosis, symptoms, medication lists, medical record numbers, Social Security numbers, patient charts, or other unnecessary protected medical information.