Skip to main content
GET
/
api
/
schedules
/
:id
curl -X GET "https://api.saludya.com/api/schedules/101" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "id": 101,
  "doctor_id": 5,
  "day_of_week": "monday",
  "start_time": "08:00:00",
  "end_time": "12:00:00",
  "is_available": true,
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-03-01T14:20:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/DUVAN100/saludya-api/llms.txt

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

Get detailed information about a specific doctor schedule including its availability status and time configuration.

Path Parameters

id
integer
required
The unique identifier of the schedule to retrieve

Response

id
integer
Unique identifier for the schedule
doctor_id
integer
ID of the doctor this schedule belongs to
day_of_week
string
Day of the week (monday-sunday)
start_time
string
Start time in HH:MM:SS format (24-hour)
end_time
string
End time in HH:MM:SS format (24-hour)
is_available
boolean
Whether this schedule slot is currently available for appointments
created_at
string
ISO 8601 timestamp of creation
updated_at
string
ISO 8601 timestamp of last update
doctor
object
Doctor information (included with expand=doctor query parameter)
id
integer
Doctor’s ID
name
string
Doctor’s full name
specialty
string
Medical specialty
curl -X GET "https://api.saludya.com/api/schedules/101" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "id": 101,
  "doctor_id": 5,
  "day_of_week": "monday",
  "start_time": "08:00:00",
  "end_time": "12:00:00",
  "is_available": true,
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-03-01T14:20:00Z"
}

Checking Doctor Availability

Use this endpoint to verify if a doctor is available during a specific time slot:
  1. Get the schedule for the doctor’s day
  2. Check is_available is true
  3. Verify desired appointment time falls between start_time and end_time
  4. Query appointments endpoint to check for conflicts
Example: Check Availability
// Step 1: Get doctor's Monday schedule
const schedule = await fetch('https://api.saludya.com/api/schedules/101').then(r => r.json());

if (!schedule.is_available) {
  console.log('Schedule is not available');
  return;
}

// Step 2: Check if desired time (10:00) falls within schedule
const desiredTime = '10:00:00';
if (desiredTime >= schedule.start_time && desiredTime < schedule.end_time) {
  console.log('Time slot is within schedule');
  // Step 3: Check for appointment conflicts (see appointments API)
}

Query Parameters

expand
string
Comma-separated list of related resources to include. Available: doctor

Build docs developers (and LLMs) love