> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nevatal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Doctor Schedule

> The doctor's full weekly schedule across all locations, with server-resolved location names

Doctor schedules are a **central** (clinic-wide) resource: no `X-Location-Id`
header is required, and the response covers every location the doctor works at.
Each schedule block carries a server-resolved `locationName` — the frontend
never maps location IDs to names.

A day may appear more than once (split shift): each block is an independent
day + location + time-range assignment.

## Path Parameters

<ParamField path="doctorId" type="string" required>The doctor's user ID</ParamField>

## Response

<ResponseField name="doctorId" type="string">The doctor's user ID.</ResponseField>

<ResponseField name="workingDays" type="array">
  Schedule blocks. Each carries `day`, `locationId`, `locationName` (resolved
  server-side), `startTime`/`endTime` (`"HH:MM"` wall-clock), and optional
  `lunchStartTime`/`lunchEndTime`.
</ResponseField>

<ResponseField name="exceptions" type="array">
  ISO 8601 dates the doctor is unavailable — doctor-wide, they apply at every location.
</ResponseField>

Returns `404 NOT_FOUND` when the doctor has no schedule configured yet (render
an empty state, not an error).

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.nevatal.com/api/v1/appointments/doctors/schedule/66dc441b8208f63a0269eecf" \
    -H "Authorization: Bearer nvtl_your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "doctorId": "66dc441b8208f63a0269eecf",
      "workingDays": [
        { "day": "monday", "locationId": "69616b710ea6a551535841bb", "locationName": "Armenia", "startTime": "08:00", "endTime": "17:00", "lunchStartTime": "12:00", "lunchEndTime": "13:00" },
        { "day": "thursday", "locationId": "696bdadfee83d82621f17748", "locationName": "Pereira", "startTime": "08:00", "endTime": "12:00" },
        { "day": "thursday", "locationId": "69616b710ea6a551535841bb", "locationName": "Armenia", "startTime": "14:00", "endTime": "17:00" }
      ],
      "exceptions": ["2026-08-07"]
    }
  }
  ```
</ResponseExample>