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

# Get Counts

`GET /appointments/v1/visits/counts`

Gets aggregate counts for the visits matching the given filters.

The counts respect all provided filters but are independent of pagination, so this can be fetched
once when filters change instead of on every page of `get_visits`.

**IMPORTANT:** Like `get_visits`, this endpoint requires a date filter on `appointment.startTimestamp`
to ensure acceptable query performance.

## Query parameters

- `filters` CommonFilterQueryString — unresolved $ref

## Headers

- `Authorization` string, required

## Response `200`

Response with status 200

- V1CountsResponse — 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)