curl --request GET \
--url https://api.example.com/api/appointments{
"appointments": [
{
"id": "<string>",
"patient_id": "<string>",
"patient_name": "<string>",
"doctor_id": "<string>",
"doctor_name": "<string>",
"specialty": "<string>",
"date": "<string>",
"time": "<string>",
"duration_minutes": 123,
"status": "<string>",
"reason": "<string>",
"notes": "<string>",
"created_at": "<string>",
"updated_at": "<string>"
}
],
"pagination": {
"current_page": 123,
"total_pages": 123,
"total_count": 123,
"per_page": 123
},
"error": {
"code": "<string>",
"message": "<string>"
}
}Retrieve a paginated list of appointments with optional filtering and sorting
curl --request GET \
--url https://api.example.com/api/appointments{
"appointments": [
{
"id": "<string>",
"patient_id": "<string>",
"patient_name": "<string>",
"doctor_id": "<string>",
"doctor_name": "<string>",
"specialty": "<string>",
"date": "<string>",
"time": "<string>",
"duration_minutes": 123,
"status": "<string>",
"reason": "<string>",
"notes": "<string>",
"created_at": "<string>",
"updated_at": "<string>"
}
],
"pagination": {
"current_page": 123,
"total_pages": 123,
"total_count": 123,
"per_page": 123
},
"error": {
"code": "<string>",
"message": "<string>"
}
}Retrieve all appointments in the system with support for pagination, filtering by status, date range, patient, and doctor, as well as sorting options.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.
scheduled, confirmed, in_progress, completed, cancelled, no_showdate, created_at, statusasc, descscheduled, confirmed, in_progress, completed, cancelled, no_showcurl -X GET "https://api.saludya.com/api/appointments?page=1&limit=10&status=scheduled&date_from=2026-03-06&sort_by=date&sort_order=asc" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
{
"appointments": [
{
"id": "apt_7k3m9n2p4q",
"patient_id": "pat_5x8y2z4a6b",
"patient_name": "María González",
"doctor_id": "doc_3j5k7m9n1p",
"doctor_name": "Dr. Carlos Ramírez",
"specialty": "Cardiología",
"date": "2026-03-10",
"time": "09:30",
"duration_minutes": 30,
"status": "scheduled",
"reason": "Consulta de control cardiovascular",
"notes": "Traer resultados de análisis de sangre",
"created_at": "2026-03-05T14:22:10Z",
"updated_at": "2026-03-05T14:22:10Z"
},
{
"id": "apt_8m4n1p5r7s",
"patient_id": "pat_6y9z3a5b7c",
"patient_name": "Juan Pérez",
"doctor_id": "doc_4k6m8n2p3q",
"doctor_name": "Dra. Ana Martínez",
"specialty": "Medicina General",
"date": "2026-03-10",
"time": "10:00",
"duration_minutes": 20,
"status": "confirmed",
"reason": "Revisión anual",
"notes": null,
"created_at": "2026-03-04T10:15:30Z",
"updated_at": "2026-03-05T16:45:22Z"
}
],
"pagination": {
"current_page": 1,
"total_pages": 5,
"total_count": 48,
"per_page": 10
}
}
{
"error": {
"code": "INVALID_PARAMETERS",
"message": "Invalid date format for date_from. Expected ISO 8601 format (YYYY-MM-DD)"
}
}
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or missing API token"
}
}
{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded. Please try again in 60 seconds"
}
}