v1
Get Visits
Gets all Visits within a given time range. The return list is ordered by start_time ascending.
IMPORTANT: This endpoint requires a date filter on appointment.startTimestamp to ensure acceptable query performance. Without date filtering, the query can take 50+ seconds on large datasets due to grouping and aggregation operations.
Example filters:
- appointment.startTimestamp|gt|2024-01-01 - appointments after January 1, 2024
- appointment.startTimestamp|eq|2024-12-08 - appointments on December 8, 2024
- appointment.startTimestamp|lt|2024-12-31 - appointments before December 31, 2024
You can combine the date filter with other filters using commas:
- appointment.startTimestamp|gt|2024-01-01,appointment.status|eq|PENDING
get/appointments/v1/visits
Query parameters
page_tokenCommonPageToken — unresolved $ref
limitinteger
sort_fieldV1SortFieldString — unresolved $ref
Defaults to appointment.start_time.
sort_directionCommonSortDirection — unresolved $ref
Defaults to ascending.
filtersCommonFilterQueryString — unresolved $ref
Required: Must include a date filter on appointment.startTimestamp (using gt, lt, or eq operators). Example: appointment.startTimestamp|gt|2024-01-01
Headers
Authorizationstring required
OAuth authentication
Response
Response with status 200
V1VisitsPage required— unresolved $ref