---
title: "Get Visits"
method: GET
path: "/appointments/v1/visits"
tags: ["v1"]
---

# Get Visits

`GET /appointments/v1/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`

## Query parameters

- `page_token` CommonPageToken — unresolved $ref
- `limit` integer
- `sort_field` V1SortFieldString — unresolved $ref
- `sort_direction` CommonSortDirection — unresolved $ref
- `filters` CommonFilterQueryString — unresolved $ref

## Headers

- `Authorization` string, required

## Response `200`

Response with status 200

- V1VisitsPage — unresolved $ref

## Other responses

- `400` — Error response with status 400

---

[API](https://skmtc.net/joincandidhealth/apis/api-reference.md) · [All operations](https://skmtc.net/joincandidhealth/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joincandidhealth/api-reference/revisions/7cc5974e4128/schema)