Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/bentlyy/Clinica/llms.txt

Use this file to discover all available pages before exploring further.

Returns all open time slots for a doctor on a specific date. Clinica generates candidate slots every 15 minutes across the doctor’s configured availability window, then removes any slot that conflicts with an existing booking or a doctor exception (full-day or partial). The response is an array of HH:MM strings ready to present in a booking UI.

Request

GET /api/bookings/available-slots — requires a patient JWT.

Headers

Authorization
string
required
Bearer token. Format: Bearer <token>

Query parameters

doctor_id
integer
required
ID of the doctor to query slots for.
date
string
required
Date to check in YYYY-MM-DD format.
duration
integer
default:"30"
Desired appointment length in minutes. Slots that would extend past the doctor’s end time are excluded.

Response

Returns an array of available time strings.
slots
string[]
Array of available start times in HH:MM format, spaced 15 minutes apart. Returns an empty array if the doctor has no availability on that day or all slots are taken.
curl --request GET \
  --url 'https://your-clinica-host/api/bookings/available-slots?doctor_id=3&date=2026-05-15&duration=30' \
  --header 'Authorization: Bearer <token>'
["09:00", "09:15", "09:30", "10:15", "10:30"]

Build docs developers (and LLMs) love