Skip to main content
GET
/
api
/
doctors
curl -X GET "https://api.saludya.com/api/doctors?specialty=Cardiology&availability=true&page=1&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "doctors": [
    {
      "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"
    },
    {
      "id": "doc_7w8x9y0z1a2b3c4d",
      "name": "Dr. James Chen",
      "specialty": "Cardiology",
      "license_number": "MD-67890-CA",
      "email": "james.chen@saludya.com",
      "phone": "+1-555-0124",
      "bio": "Specialized in cardiac imaging and non-invasive cardiology. Fellowship trained at Mayo Clinic with expertise in echocardiography.",
      "available": true,
      "created_at": "2024-02-01T09:15:00Z",
      "updated_at": "2024-02-28T11:45:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "pages": 1
  }
}

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.

​
Query Parameters

​
specialty
string
Filter doctors by medical specialty (e.g., “Cardiology”, “Pediatrics”, “Dermatology”)
​
availability
boolean
Filter doctors by availability status. Set to true to show only available doctors
​
page
integer
default:"1"
Page number for pagination
​
limit
integer
default:"20"
Number of results per page (max: 100)
​
search
string
Search doctors by name, specialty, or license number

​
Response

​
doctors
array
Array of doctor objects
​
id
string
Unique identifier for the doctor
​
name
string
Full name of the doctor
​
specialty
string
Medical specialty or specialization
​
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 to the system
​
updated_at
string
ISO 8601 timestamp of last update
​
pagination
object
Pagination metadata
​
page
integer
Current page number
​
limit
integer
Results per page
​
total
integer
Total number of doctors matching the query
​
pages
integer
Total number of pages
curl -X GET "https://api.saludya.com/api/doctors?specialty=Cardiology&availability=true&page=1&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "doctors": [
    {
      "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"
    },
    {
      "id": "doc_7w8x9y0z1a2b3c4d",
      "name": "Dr. James Chen",
      "specialty": "Cardiology",
      "license_number": "MD-67890-CA",
      "email": "james.chen@saludya.com",
      "phone": "+1-555-0124",
      "bio": "Specialized in cardiac imaging and non-invasive cardiology. Fellowship trained at Mayo Clinic with expertise in echocardiography.",
      "available": true,
      "created_at": "2024-02-01T09:15:00Z",
      "updated_at": "2024-02-28T11:45:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "pages": 1
  }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us