---
title: "Changes to Returns providers for the specified recruitment cycle."
method: GET
path: "/recruitment_cycles/{year}/providers"
---

# Changes to Returns providers for the specified recruitment cycle.

`GET /recruitment_cycles/{year}/providers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 20 of 75 revisions.

- **2026-03-27** `75fe5c106869`: 1 info
- **2024-08-21** `b84bbd45a693`: 1 info
- **2023-07-19** `ffdd435aaba5`: 1 info
- **2023-04-26** `5db272dd67ad`: 1 info
- **2022-08-19** `5ddfd8949e65`: 2 info
- **2022-08-19** `9a32b6eb3b16`: 2 warning
- **2021-10-26** `4264644c11cb`: 2 info
- **2021-10-22** `5378287d5ae4`: 2 warning
- **2021-10-22** `1523accfe5a2`: 2 info
- **2021-09-01** `d7e1b1c9cc37`: 2 info
- **2021-08-27** `b06d5c634612`: 2 warning
- **2021-08-23** `fe500f06fe56`: 2 info
- **2021-07-20** `c55e3a60e42e`: 2 info
- **2021-01-27** `074297e2142c`: 1 warning
- **2021-01-25** `61f872157dd6`: 1 info
- **2021-01-25** `023bcb20febe`: 1 warning
- **2021-01-20** `0af5f8d547e9`: 1 info
- **2021-01-15** `640cc388a4ca`: 1 breaking, 1 warning, 5 info
- **2021-01-14** `f863d4639aa5`: 2 warning, 4 info
- **2021-01-06** `e22134da5cd2`: 2 info

## Changes

- **2026-03-27** `75fe5c106869`: 1 info
  - for the `query` request parameter `include`, the type was generalized from no type to `string`
- **2024-08-21** `b84bbd45a693`: 1 info
  - added the optional property `data/items/attributes/selectable_school` to the response with the `200` status
- **2023-07-19** `ffdd435aaba5`: 1 info
  - added the optional property `data/items/attributes/discarded_at` to the response with the `200` status
- **2023-04-26** `5db272dd67ad`: 1 info
  - added the optional property `data/items/attributes/street_address_3` to the response with the `200` status
- **2022-08-19** `5ddfd8949e65`: 2 info
  - removed the `invalid_value` enum value from the `data/items/attributes/provider_type` response property for the response status `200`
  - removed the `unknown` enum value from the `data/items/attributes/provider_type` response property for the response status `200`
- **2022-08-19** `9a32b6eb3b16`: 2 warning
  - added the new `invalid_value` enum value to the `data/items/attributes/provider_type` response property for the response status `200`
  - added the new `unknown` enum value to the `data/items/attributes/provider_type` response property for the response status `200`
- **2021-10-26** `4264644c11cb`: 2 info
  - removed the `invalid_value` enum value from the `data/items/attributes/provider_type` response property for the response status `200`
  - removed the `unknown` enum value from the `data/items/attributes/provider_type` response property for the response status `200`
- **2021-10-22** `5378287d5ae4`: 2 warning
  - added the new `invalid_value` enum value to the `data/items/attributes/provider_type` response property for the response status `200`
  - added the new `unknown` enum value to the `data/items/attributes/provider_type` response property for the response status `200`
- **2021-10-22** `1523accfe5a2`: 2 info
  - removed the `invalid_value` enum value from the `data/items/attributes/provider_type` response property for the response status `200`
  - removed the `unknown` enum value from the `data/items/attributes/provider_type` response property for the response status `200`
- **2021-09-01** `d7e1b1c9cc37`: 2 info
  - added the optional property `data/items/attributes/can_sponsor_skilled_worker_visa` to the response with the `200` status
  - added the optional property `data/items/attributes/can_sponsor_student_visa` to the response with the `200` status
- **2021-08-27** `b06d5c634612`: 2 warning
  - removed the optional property `data/items/attributes/can_sponsor_skilled_worker_visa` from the response with the `200` status
  - removed the optional property `data/items/attributes/can_sponsor_student_visa` from the response with the `200` status
- **2021-08-23** `fe500f06fe56`: 2 info
  - added the optional property `data/items/attributes/can_sponsor_skilled_worker_visa` to the response with the `200` status
  - added the optional property `data/items/attributes/can_sponsor_student_visa` to the response with the `200` status
- **2021-07-20** `c55e3a60e42e`: 2 info
  - added the optional property `data/items/attributes/ukprn` to the response with the `200` status
  - added the optional property `data/items/attributes/urn` to the response with the `200` status
- **2021-01-27** `074297e2142c`: 1 warning
  - removed the optional property `data/items/relationships/recruitment_cycle/meta` from the response with the `200` status
- **2021-01-25** `61f872157dd6`: 1 info
  - added the new optional `query` request parameter `filter`
- **2021-01-25** `023bcb20febe`: 1 warning
  - deleted the `query` request parameter `filter`
- **2021-01-20** `0af5f8d547e9`: 1 info
  - added the new optional `query` request parameter `filter`
- **2021-01-15** `640cc388a4ca`: 1 breaking, 1 warning, 5 info
  - the `included/items/` response's property type changed from no type to `object` for status `200`
  - removed the optional property `data/items/relationships/locations` from the response with the `200` status
  - removed `#/components/schemas/CourseResource, #/components/schemas/LocationResource, #/components/schemas/LocationStatusResource, #/components/schemas/ProviderResource, #/components/schemas/RecruitmentCycleResource, #/components/schemas/SubjectResource` from the `included/items/` response property `anyOf` list for the response status `200`
  - removed discriminator from `included/items/` response property for the response status `200`
  - added the required property `included/items/attributes` to the response with the `200` status
  - added the required property `included/items/id` to the response with the `200` status
  - added the required property `included/items/type` to the response with the `200` status
- **2021-01-14** `f863d4639aa5`: 2 warning, 4 info
  - removed the optional property `included/items/anyOf[#/components/schemas/LocationResource]/attributes/email` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/LocationResource]/attributes/telephone` from the response with the `200` status
  - added the optional property `data/items/attributes/email` to the response with the `200` status
  - added the optional property `data/items/attributes/telephone` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/email` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/telephone` to the response with the `200` status
- **2021-01-06** `e22134da5cd2`: 2 info
  - added the optional property `included/items/anyOf[#/components/schemas/LocationResource]/attributes/email` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/LocationResource]/attributes/telephone` to the response with the `200` status

---

[Operation](https://skmtc.dev/department-for-education/apis/teacher-training-courses-api/docs/recruitment_cycles/:year/providers/get.md) - [API](https://skmtc.dev/department-for-education/apis/teacher-training-courses-api.md) - [Page](https://skmtc.dev/department-for-education/apis/teacher-training-courses-api/changes/recruitment_cycles/:year/providers/get)
