Get Doctor Schedule

curl "https://api.nevatal.com/api/v1/appointments/doctors/schedule/66dc441b8208f63a0269eecf" \
  -H "Authorization: Bearer nvtl_your_api_key"

{
  "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"]
  }
}

GET

api

appointments

doctors

schedule

{doctorId}

curl "https://api.nevatal.com/api/v1/appointments/doctors/schedule/66dc441b8208f63a0269eecf" \
  -H "Authorization: Bearer nvtl_your_api_key"

{
  "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"]
  }
}

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

doctorId

string

required

The doctor’s user ID

Response

doctorId

string

The doctor’s user ID.

workingDays

array

Schedule blocks. Each carries day, locationId, locationName (resolved server-side), startTime/endTime ("HH:MM" wall-clock), and optional lunchStartTime/lunchEndTime.

exceptions

array

ISO 8601 dates the doctor is unavailable — doctor-wide, they apply at every location.

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

curl "https://api.nevatal.com/api/v1/appointments/doctors/schedule/66dc441b8208f63a0269eecf" \
  -H "Authorization: Bearer nvtl_your_api_key"

{
  "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"]
  }
}

Cancel Appointment Get Schedule Form Schema

Overview

Patients

Appointments

Billing

Clinical Procedures

EMR

Odontogram

Locations

Webhooks

Path Parameters

Response

​Path Parameters

​Response

Path Parameters

Response