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

# Changes to Returns the locations for the specified provider.

`GET /recruitment_cycles/{year}/providers/{provider_code}/locations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 31 of 75 revisions.

- **2026-10-22** `4e9e8f725299`: 3 info
- **2026-08-21** `c34835686364`: 12 info
- **2026-07-23** `11e6b5e3808b`: 2 info
- **2026-03-27** `75fe5c106869`: 1 info
- **2025-02-05** `7c2a20970cce`: 1 info
- **2024-09-23** `84bc2ac4d48e`: 2 info
- **2024-08-21** `b84bbd45a693`: 1 info
- **2024-05-13** `f3e0c328811e`: 2 warning
- **2023-07-19** `ffdd435aaba5`: 1 info
- **2023-06-05** `ebc38c66cb49`: 1 warning, 2 info
- **2023-04-26** `5db272dd67ad`: 1 info
- **2023-04-13** `0fcf69f87a83`: 1 info
- **2023-01-20** `f3ed8b5d1244`: 2 breaking
- **2023-01-03** `b46a9e2214b0`: 2 warning
- **2022-11-16** `21f4e941946b`: 2 info
- **2022-11-02** `38e161caa65b`: 1 info
- **2022-08-31** `706b57ce7426`: 2 info
- **2022-08-19** `5ddfd8949e65`: 2 info
- **2022-08-19** `9a32b6eb3b16`: 2 warning, 2 info
- **2021-10-26** `4264644c11cb`: 2 info
- **2021-10-22** `5378287d5ae4`: 2 warning, 1 info
- **2021-10-22** `1523accfe5a2`: 2 info
- **2021-09-01** `d7e1b1c9cc37`: 10 info
- **2021-08-27** `b06d5c634612`: 10 warning
- **2021-08-23** `fe500f06fe56`: 10 info
- **2021-07-20** `c55e3a60e42e`: 2 info
- **2021-03-04** `ff7d4232c417`: 1 info
- **2021-01-27** `074297e2142c`: 9 warning, 1 info
- **2021-01-15** `640cc388a4ca`: 1 breaking, 5 warning, 6 info
- **2021-01-14** `f863d4639aa5`: 4 warning, 2 info
- **2021-01-06** `e22134da5cd2`: 4 info

## Changes

- **2026-10-22** `4e9e8f725299`: 3 info
  - response property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/has_vacancies` deprecated
  - response property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/open_for_applications` deprecated
  - response property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/running` deprecated
- **2026-08-21** `c34835686364`: 12 info
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/additional_fees` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/assessment_methods` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/duration_per_school` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/fee_schedule` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/interview_location` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/placement_school_activities` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/placement_selection_criteria` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/salary_fee_details` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/support_and_mentorship` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/theoretical_training_activities` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/theoretical_training_duration` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/theoretical_training_location` to the response with the `200` status
- **2026-07-23** `11e6b5e3808b`: 2 info
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/school_experience_required` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/school_experience_required_content` to the response with the `200` status
- **2026-03-27** `75fe5c106869`: 1 info
  - for the `query` request parameter `include`, the type was generalized from no type to `string`
- **2025-02-05** `7c2a20970cce`: 1 info
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/visa_sponsorship_application_deadline_at` to the response with the `200` status
- **2024-09-23** `84bc2ac4d48e`: 2 info
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/degree_type` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/training_route` to the response with the `200` status
- **2024-08-21** `b84bbd45a693`: 1 info
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/selectable_school` to the response with the `200` status
- **2024-05-13** `f3e0c328811e`: 2 warning
  - added the new `qts, undergraduate_degree` enum value to the `included/items/anyOf[#/components/schemas/CourseResource]/attributes/qualifications` response property for the response status `200`
  - added the new `teacher_degree_apprenticeship` enum value to the `included/items/anyOf[#/components/schemas/CourseResource]/attributes/program_type` response property for the response status `200`
- **2023-07-19** `ffdd435aaba5`: 1 info
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/discarded_at` to the response with the `200` status
- **2023-06-05** `ebc38c66cb49`: 1 warning, 2 info
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accredited_body_code` from the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accredited_provider_code` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/application_status` to the response with the `200` status
- **2023-04-26** `5db272dd67ad`: 1 info
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/street_address_3` to the response with the `200` status
- **2023-04-13** `0fcf69f87a83`: 1 info
  - added the optional property `data/items/attributes/street_address_3` to the response with the `200` status
- **2023-01-20** `f3ed8b5d1244`: 2 breaking
  - removed the enum value `course` from the `query` request parameter `include`
  - removed the enum value `location_status` from the `query` request parameter `include`
- **2023-01-03** `b46a9e2214b0`: 2 warning
  - added the new `engineers_teach_physics` enum value to the `included/items/anyOf[#/components/schemas/CourseResource]/attributes/campaign_name` response property for the response status `200`
  - added the new `no_campaign` enum value to the `included/items/anyOf[#/components/schemas/CourseResource]/attributes/campaign_name` response property for the response status `200`
- **2022-11-16** `21f4e941946b`: 2 info
  - removed the `engineers_teach_physics` enum value from the `included/items/anyOf[#/components/schemas/CourseResource]/attributes/campaign_name` response property for the response status `200`
  - removed the `no_campaign` enum value from the `included/items/anyOf[#/components/schemas/CourseResource]/attributes/campaign_name` response property for the response status `200`
- **2022-11-02** `38e161caa65b`: 1 info
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/campaign_name` to the response with the `200` status
- **2022-08-31** `706b57ce7426`: 2 info
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/can_sponsor_skilled_worker_visa` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/can_sponsor_student_visa` to the response with the `200` status
- **2022-08-19** `5ddfd8949e65`: 2 info
  - removed the `invalid_value` enum value from the `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/provider_type` response property for the response status `200`
  - removed the `unknown` enum value from the `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/provider_type` response property for the response status `200`
- **2022-08-19** `9a32b6eb3b16`: 2 warning, 2 info
  - added the new `invalid_value` enum value to the `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/provider_type` response property for the response status `200`
  - added the new `unknown` enum value to the `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/provider_type` response property for the response status `200`
  - removed the `empty` enum value from the `included/items/anyOf[#/components/schemas/CourseResource]/attributes/state` response property for the response status `200`
  - removed the `published_with_unpublished_changes` enum value from the `included/items/anyOf[#/components/schemas/CourseResource]/attributes/state` response property for the response status `200`
- **2021-10-26** `4264644c11cb`: 2 info
  - removed the `invalid_value` enum value from the `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/provider_type` response property for the response status `200`
  - removed the `unknown` enum value from the `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/provider_type` response property for the response status `200`
- **2021-10-22** `5378287d5ae4`: 2 warning, 1 info
  - added the new `invalid_value` enum value to the `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/provider_type` response property for the response status `200`
  - added the new `unknown` enum value to the `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/provider_type` response property for the response status `200`
  - added the optional property `data/items/attributes/uuid` to the response with the `200` status
- **2021-10-22** `1523accfe5a2`: 2 info
  - removed the `invalid_value` enum value from the `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/provider_type` response property for the response status `200`
  - removed the `unknown` enum value from the `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/provider_type` response property for the response status `200`
- **2021-09-01** `d7e1b1c9cc37`: 10 info
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_english_gcse_equivalency` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_gcse_equivalency` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_maths_gcse_equivalency` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_pending_gcse` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_science_gcse_equivalency` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/additional_gcse_equivalencies` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/degree_grade` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/degree_subject_requirements` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/can_sponsor_skilled_worker_visa` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/can_sponsor_student_visa` to the response with the `200` status
- **2021-08-27** `b06d5c634612`: 10 warning
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_english_gcse_equivalency` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_gcse_equivalency` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_maths_gcse_equivalency` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_pending_gcse` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_science_gcse_equivalency` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/additional_gcse_equivalencies` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/degree_grade` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/degree_subject_requirements` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/can_sponsor_skilled_worker_visa` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/can_sponsor_student_visa` from the response with the `200` status
- **2021-08-23** `fe500f06fe56`: 10 info
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_english_gcse_equivalency` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_gcse_equivalency` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_maths_gcse_equivalency` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_pending_gcse` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/accept_science_gcse_equivalency` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/additional_gcse_equivalencies` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/degree_grade` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/degree_subject_requirements` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/can_sponsor_skilled_worker_visa` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/can_sponsor_student_visa` to the response with the `200` status
- **2021-07-20** `c55e3a60e42e`: 2 info
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/ukprn` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/attributes/urn` to the response with the `200` status
- **2021-03-04** `ff7d4232c417`: 1 info
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/attributes/subject_codes` to the response with the `200` status
- **2021-01-27** `074297e2142c`: 9 warning, 1 info
  - removed the optional property `data/items/relationships/course/meta` from the response with the `200` status
  - removed the optional property `data/items/relationships/location_status/meta` from the response with the `200` status
  - removed the optional property `data/items/relationships/provider/meta` from the response with the `200` status
  - removed the optional property `data/items/relationships/recruitment_cycle/meta` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/relationships/accredited_body/meta` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/relationships/provider/meta` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/relationships/recruitment_cycle/meta` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/LocationStatusResource]/attributes/relationships` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/relationships/recruitment_cycle/meta` from the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/LocationStatusResource]/relationships` to the response with the `200` status
- **2021-01-15** `640cc388a4ca`: 1 breaking, 5 warning, 6 info
  - the `included/items/anyOf[#/components/schemas/RecruitmentCycleResource]/id` response's property type changed from `integer` to `string` for status `200`
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/relationships/locations` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/relationships/modern_languages` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/relationships/provider_locations` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/CourseResource]/relationships/subjects` from the response with the `200` status
  - removed the optional property `included/items/anyOf[#/components/schemas/ProviderResource]/relationships/locations` from the response with the `200` status
  - added the new enum value `course` to the `query` request parameter `include`
  - added the new enum value `location_status` to the `query` request parameter `include`
  - added the optional property `data/items/relationships/location_status` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/CourseResource]/relationships/recruitment_cycle` to the response with the `200` status
  - removed `#/components/schemas/LocationResource, #/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`
- **2021-01-14** `f863d4639aa5`: 4 warning, 2 info
  - removed the optional property `data/items/attributes/email` from the response with the `200` status
  - removed the optional property `data/items/attributes/telephone` from the response with the `200` status
  - 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 `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`: 4 info
  - 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/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/:provider_code/locations/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/:provider_code/locations/get)
