---
title: "Changes to Get Visits"
method: GET
path: "/appointments/v1/visits"
---

# Changes to Get Visits

`GET /appointments/v1/visits`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 15 revisions.

- **2026-10-29** `d8b0a61873e2`: 2 info
- **2026-09-19** `72fc5ca65ba5`: 2 warning, 7 info
- **2026-09-17** `24b2d80d577a`: 3 breaking, 1 warning, 13 info
- **2026-09-12** `3a81ee81d4ed`: 1 info

## Changes

- **2026-10-29** `d8b0a61873e2`: 2 info
  - added the optional property `items/items/patient/referrals/items/payer_id` to the response with the `200` status
  - added the optional property `items/items/patient/referrals/items/payer_name` to the response with the `200` status
- **2026-09-19** `72fc5ca65ba5`: 2 warning, 7 info
  - added the new `CHECKED_OUT` enum value to the `items/items/status` response property for the response status `200`
  - added the new `NO_SHOW` enum value to the `items/items/status` response property for the response status `200`
  - added the optional property `items/items/patient/contacts/items/addresses/items/administrative_area` to the response with the `200` status
  - added the optional property `items/items/patient/general_practitioners/items/addresses/items/administrative_area` to the response with the `200` status
  - added the optional property `items/items/patient/guarantor/address/administrative_area` to the response with the `200` status
  - added the optional property `items/items/patient/origination_detail/referring_provider/addresses/items/administrative_area` to the response with the `200` status
  - added the optional property `items/items/patient/other_addresses/items/administrative_area` to the response with the `200` status
  - added the optional property `items/items/patient/primary_address/administrative_area` to the response with the `200` status
  - added the optional property `items/items/patient/referrals/items/provider/addresses/items/administrative_area` to the response with the `200` status
- **2026-09-17** `24b2d80d577a`: 3 breaking, 1 warning, 13 info
  - the `query` request parameter `sort_direction` was restricted to a list of enum values
  - the response's body type changed from no type to `object` for status `200`
  - the `content` response's property type changed from no type to `object` for status `400`
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `OAuthScheme` was added to the API
  - added the new enum value `asc` to the `query` request parameter `sort_direction`
  - added the new enum value `desc` to the `query` request parameter `sort_direction`
  - for the `query` request parameter `filters`, the type was generalized from no type to `string`
  - for the `query` request parameter `page_token`, the type was generalized from no type to `string`
  - for the `query` request parameter `sort_direction`, the type was generalized from no type to `string`
  - for the `query` request parameter `sort_field`, the type was generalized from no type to `string`
  - added the optional property `content/data` to the response with the `400` status
  - added the optional property `next_page_token` to the response with the `200` status
  - added the optional property `prev_page_token` to the response with the `200` status
  - added the required property `content/message` to the response with the `400` status
  - added the required property `items` to the response with the `200` status
  - added the required property `total` to the response with the `200` status
- **2026-09-12** `3a81ee81d4ed`: 1 info
  - api operation id `get_visits` removed and replaced with `v1_get_visits`

---

[Operation](https://skmtc.dev/joincandidhealth/apis/api-reference/docs/appointments/v1/visits/get.md) - [API](https://skmtc.dev/joincandidhealth/apis/api-reference.md) - [Page](https://skmtc.dev/joincandidhealth/apis/api-reference/changes/appointments/v1/visits/get)