curl -X GET "https://api.nevatal.com/api/v1/appointments?from=2025-04-01&to=2025-04-30&status=confirmed" \
  -H "Authorization: Bearer nvtl_your_api_key"

{
  "data": [
    {
      "id": "apt_xyz789",
      "patientId": "pat_abc123",
      "patient": {
        "firstName": "María",
        "lastName": "García"
      },
      "doctorId": "usr_doctor456",
      "doctor": {
        "id": "usr_doctor456",
        "fullName": "Dr. Carlos López",
        "color": "#2563EB",
        "firstName": "Dr. Carlos",
        "lastName": "López"
      },
      "locationId": "loc_main",
      "procedureId": "proc_general_consult",
      "procedure": {
        "name": "Consulta General"
      },
      "startTime": "2025-04-01T09:00:00-05:00",
      "endTime": "2025-04-01T09:30:00-05:00",
      "status": "confirmed",
      "notes": "Initial consultation",
      "createdAt": "2025-03-20T15:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45
  }
}