Check Availability

GET /availability

Returns available time slots for a doctor on a given date.

Scope required: appointment.read.availability

Query Parameters

Parameter	Type	Required	Description
doctor_id	UUID	✅	User UUID of the physician
date	string	✅	Y-m-d (clinic-local)
duration	integer	—	Slot duration in minutes

Request

GET /api/developer/v1/availability?doctor_id=018d1e2f-…&date=2026-02-15
Authorization: Developer wc_live_…:wcs_live_…

Response 200

{
  "data": [
    { "start_time": "09:00", "end_time": "09:30", "duration_minutes": 30 },
    { "start_time": "09:30", "end_time": "10:00", "duration_minutes": 30 },
    { "start_time": "11:00", "end_time": "11:30", "duration_minutes": 30 }
  ],
  "meta": {
    "date": "2026-02-15",
    "doctor_id": "018d1e2f-…",
    "duration_minutes": 30,
    "count": 3
  }
}