Skip to main content
GET
/
api
/
doctors
/
:id
curl -X GET "https://api.saludya.com/api/doctors/doc_8x9y2z3a4b5c6d7e" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "doc_8x9y2z3a4b5c6d7e",
  "name": "Dr. Maria Garcia",
  "specialty": "Cardiology",
  "license_number": "MD-12345-CA",
  "email": "maria.garcia@saludya.com",
  "phone": "+1-555-0123",
  "bio": "Board-certified cardiologist with 15 years of experience in interventional cardiology and heart disease prevention. Graduate of Stanford Medical School.",
  "available": true,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-03-01T14:22: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.

​
Path Parameters

​
id
string
required
Unique identifier of the doctor (e.g., “doc_8x9y2z3a4b5c6d7e”)

​
Query Parameters

​
include
string
Comma-separated list of related resources to include in the response. Options: schedules, appointments, stats
  • schedules: Include the doctor’s availability schedules
  • appointments: Include upcoming appointments
  • stats: Include statistics (total appointments, average rating, etc.)

​
Response

​
id
string
Unique identifier for the doctor
​
name
string
Full name of the doctor
​
specialty
string
Medical specialty
​
license_number
string
Professional medical license number
​
email
string
Doctor’s contact email address
​
phone
string
Doctor’s contact phone number
​
bio
string
Professional biography and credentials
​
available
boolean
Whether the doctor is currently accepting new patients
​
created_at
string
ISO 8601 timestamp of when the doctor was added
​
updated_at
string
ISO 8601 timestamp of last update
​
schedules
array
Available when include=schedules is specified. Array of schedule objects.
​
id
string
Schedule identifier
​
day_of_week
string
Day of the week (e.g., “Monday”, “Tuesday”)
​
start_time
string
Start time in HH:MM format (e.g., “09:00”)
​
end_time
string
End time in HH:MM format (e.g., “17:00”)
​
appointments
array
Available when include=appointments is specified. Array of upcoming appointment objects.
​
id
string
Appointment identifier
​
patient_name
string
Name of the patient
​
appointment_date
string
ISO 8601 timestamp of the appointment
​
status
string
Appointment status (e.g., “scheduled”, “confirmed”, “completed”)
​
stats
object
Available when include=stats is specified. Statistical information.
​
total_appointments
integer
Total number of appointments completed
​
average_rating
number
Average patient rating (0-5)
​
active_patients
integer
Number of active patients
curl -X GET "https://api.saludya.com/api/doctors/doc_8x9y2z3a4b5c6d7e" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "doc_8x9y2z3a4b5c6d7e",
  "name": "Dr. Maria Garcia",
  "specialty": "Cardiology",
  "license_number": "MD-12345-CA",
  "email": "maria.garcia@saludya.com",
  "phone": "+1-555-0123",
  "bio": "Board-certified cardiologist with 15 years of experience in interventional cardiology and heart disease prevention. Graduate of Stanford Medical School.",
  "available": true,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-03-01T14:22:00Z"
}

​
Use Cases

  • Patient portal - Display doctor profiles with specialties and bios
  • Appointment booking - Show available doctors and their schedules
  • Analytics dashboard - View doctor performance metrics and statistics
  • Verification - Validate doctor credentials and license information

Build docs developers (and LLMs) love

Get started for freeTalk to us