---
title: "Changes to Get Appointment List"
method: GET
path: "/lists/v1/appointment"
---

# Changes to Get Appointment List

`GET /lists/v1/appointment`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 15 revisions.

- **2026-10-29** `d8b0a61873e2`: 14 warning, 5 info
- **2026-09-24** `4074901c170f`: 1 info
- **2026-09-19** `72fc5ca65ba5`: 2 warning, 18 info
- **2026-09-17** `24b2d80d577a`: 2 breaking, 1 warning, 11 info
- **2026-09-12** `3a81ee81d4ed`: 1 info

## Changes

- **2026-10-29** `d8b0a61873e2`: 14 warning, 5 info
  - added the new `ABA` enum value to the `items/items/primary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `ABA` enum value to the `items/items/secondary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `CES` enum value to the `items/items/primary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `CES` enum value to the `items/items/secondary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `EEG` enum value to the `items/items/primary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `EEG` enum value to the `items/items/secondary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `FWC` enum value to the `items/items/primary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `FWC` enum value to the `items/items/secondary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `OT` enum value to the `items/items/primary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `OT` enum value to the `items/items/secondary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `PT` enum value to the `items/items/primary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `PT` enum value to the `items/items/secondary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `SLP` enum value to the `items/items/primary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the new `SLP` enum value to the `items/items/secondary_coverage/insurance_plan/carve_outs/items/carve_out` response property for the response status `200`
  - added the optional property `items/items/appointment/devices` to the response with the `200` status
  - added the optional property `items/items/appointment/ready_reason` to the response with the `200` status
  - added the optional property `items/items/appointment/rooms` to the response with the `200` status
  - 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-24** `4074901c170f`: 1 info
  - added the optional property `items/items/appointment/cancellation_reason` to the response with the `200` status
- **2026-09-19** `72fc5ca65ba5`: 2 warning, 18 info
  - added the new `CHECKED_OUT` enum value to the `items/items/appointment/status` response property for the response status `200`
  - added the new `NO_SHOW` enum value to the `items/items/appointment/status` response property for the response status `200`
  - added the optional property `items/items/appointment/appointment_reason_detail` to the response with the `200` status
  - added the optional property `items/items/appointment/attending_doctor/addresses/items/administrative_area` to the response with the `200` status
  - added the optional property `items/items/appointment/checked_out_timestamp` to the response with the `200` status
  - added the optional property `items/items/appointment/medical_necessity_verified` to the response with the `200` status
  - added the optional property `items/items/appointment/prior_authorization_status` to the response with the `200` status
  - 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
  - added the optional property `items/items/primary_coverage/insurance_plan/address/administrative_area` to the response with the `200` status
  - added the optional property `items/items/primary_coverage/latest_eligibility_check/trading_partner` to the response with the `200` status
  - added the optional property `items/items/primary_coverage/subscriber/address/administrative_area` to the response with the `200` status
  - added the optional property `items/items/secondary_coverage/insurance_plan/address/administrative_area` to the response with the `200` status
  - added the optional property `items/items/secondary_coverage/latest_eligibility_check/trading_partner` to the response with the `200` status
  - added the optional property `items/items/secondary_coverage/subscriber/address/administrative_area` to the response with the `200` status
- **2026-09-17** `24b2d80d577a`: 2 breaking, 1 warning, 11 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`
  - 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 `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 `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_appointment_list` removed and replaced with `v1_get_appointment_list`

---

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