Skip to main content
GET
/
api
/
v1
/
appointments
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": {
        "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
  }
}

​
Query Parameters

​
page
integer
default:"1"
Page number
​
limit
integer
default:"20"
Results per page (max: 100)
​
locationId
string
Filter by location
​
doctorId
string
Filter by doctor
​
patientId
string
Filter by patient
​
status
string
Filter by status: confirmed, completed, canceled, no_show
​
from
string
Start date filter (YYYY-MM-DD)
​
to
string
End date filter (YYYY-MM-DD)
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": {
        "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
  }
}