---
title: "Changes to Get all contracts"
method: GET
path: "/api/contracts/v3"
---

# Changes to Get all contracts

`GET /api/contracts/v3`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 15 revisions.

- **2026-10-15** `97de8fddb088`: 1 breaking, 1 info
- **2026-09-17** `24b2d80d577a`: 4 breaking, 1 warning, 20 info
- **2026-09-12** `3a81ee81d4ed`: 1 info
- **2026-09-01** `1ae110d4149b`: 1 info

## Changes

- **2026-10-15** `97de8fddb088`: 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the `items/items/` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `items/items/` response property `oneOf` list for the response status `200`
- **2026-09-17** `24b2d80d577a`: 4 breaking, 1 warning, 20 info
  - the `query` request parameter `contract_status` was restricted to a list of enum values
  - the `query` request parameter `sort` was restricted to a list of enum values
  - the `query` request parameter `type` 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 `billing_provider_name` to the `query` request parameter `sort`
  - added the new enum value `cancelled` to the `query` request parameter `contract_status`
  - added the new enum value `contract_status` to the `query` request parameter `sort`
  - added the new enum value `created_at` to the `query` request parameter `sort`
  - added the new enum value `effective` to the `query` request parameter `contract_status`
  - added the new enum value `effective_date` to the `query` request parameter `sort`
  - added the new enum value `institutional` to the `query` request parameter `type`
  - added the new enum value `payer_id` to the `query` request parameter `sort`
  - added the new enum value `payer_name` to the `query` request parameter `sort`
  - added the new enum value `pending` to the `query` request parameter `contract_status`
  - added the new enum value `professional` to the `query` request parameter `type`
  - for the `query` request parameter `contract_status`, the type was generalized from no type to `string`
  - for the `query` request parameter `contracting_provider_id`, the type was generalized from no type to `string`, and format from no format to `uuid`
  - for the `query` request parameter `rendering_provider_ids`, the type was generalized from no type to `string`, and format from no format to `uuid`
  - for the `query` request parameter `sort`, the type was generalized from no type to `string`
  - for the `query` request parameter `type`, 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
- **2026-09-12** `3a81ee81d4ed`: 1 info
  - api operation id `get_multi` removed and replaced with `v3_get_multi`
- **2026-09-01** `1ae110d4149b`: 1 info
  - added the new enum value `FC` to the `query` request parameter `states`

---

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