List appointments
Returns scheduled appointments filtered by patient, provider, location, or date range. Includes status, duration, and telehealth join URLs when applicable.
Last updated
GET
/v1/appointmentsPower scheduling widgets, day sheets, and reminder workflows with this endpoint. Combine patient_id and scheduled_at filters to fetch upcoming visits for a single patient, or query by provider_id for a clinician agenda view.
GET
/v1/appointmentsAuth requiredLists appointments with optional filters for patient, provider, and date range.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| patient_id | query | string | No | Filter to one patient. |
| provider_id | query | string | No | Filter to one provider agenda. |
| scheduled_at[gte] | query | timestamp | No | On or after Unix timestamp. |
| status | query | enum | No | scheduled | confirmed | completed | cancelled | no_show |
Common filters
| Parameter | Example | Description |
|---|---|---|
| patient_id | pat_8Kx2mN1qRt | Appointments for one patient |
| provider_id | prv_2Qx9kLm4pZ | Agenda for a clinician |
| scheduled_at[gte] | 1720051200 | On or after Unix timestamp |
| status | confirmed | scheduled, confirmed, completed, cancelled, no_show |
Today's agendabash
curl "https://api.vcaremd.com/v1/appointments?provider_id=prv_2Qx9kLm4pZ&scheduled_at[gte]=1720051200" \
-H "Authorization: Bearer sk_test_YOUR_SECRET_KEY"Response fields
- id — unique appointment identifier (apt_)
- status — lifecycle state of the visit
- duration_minutes — scheduled length
- telehealth_url — present when visit_type is telehealth
- location_id — physical site when in-person
Was this page helpful?
Your feedback helps us improve our documentation.