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"]
}
}
Appointments
Get Doctor Schedule
The doctor’s full weekly schedule across all locations, with server-resolved location names
GET
/
api
/
v1
/
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
Returns
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
string
required
The doctor’s user ID
Response
string
The doctor’s user ID.
array
Schedule blocks. Each carries
day, locationId, locationName (resolved
server-side), startTime/endTime ("HH:MM" wall-clock), and optional
lunchStartTime/lunchEndTime.array
ISO 8601 dates the doctor is unavailable — doctor-wide, they apply at every location.
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"]
}
}