v50

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-23105087.3 KB

provider

Returns providers for the specified recruitment cycle.

get/recruitment_cycles/{year}/providers

Path parameters

yearstring required

The starting year of the recruitment cycle. Also accepts "current" for the current recruitment cycle. Defaults to current recruitment cycle if invalid year (eg "1066") is provided

Query parameters

sortstring[]

This schema is used to sort a collection.

Field(s) to sort the providers by.

[
  "name"
]

can_sponsor_skilled_worker_visaboolean

Only return providers that can sponsor a Skilled Worker visa.

can_sponsor_student_visaboolean

Only return providers that can sponsor a Student visa.

is_accredited_bodyboolean

Only return providers that are accredited providers.

provider_namestring

Return providers where the provider name includes the input string.

provider_type'lead_school' | 'scitt' | 'university'

Return providers based on their provider type. This is a comma delimited string. If multiple provider types are provided then any provider matching any one of the options provider will be returned, i.e. the OR operator is used.

Return providers based on their region code. This is a comma delimited string. If multiple region codes are provided then any provider matching any one of the options provider will be returned, i.e. the OR operator is used.

updated_sincestring

Return providers that have been updated since the date (ISO 8601 date format)

discardedboolean

Return only providers that have been decommissioned. Using this filter will add the discarded_at property to the attributes of the returned providers.

Refine providers to return.

{
  "can_sponsor_skilled_worker_visa": true,
  "can_sponsor_student_visa": true,
  "is_accredited_body": true,
  "provider_name": "oxf",
  "provider_type": "scitt,lead_school",
  "region_code": "london,yorkshire_and_the_humber",
  "updated_since": "2020-11-13T11:21:55Z"
}

pageinteger

The page number to paginate to in the collection. If no value is specified it defaults to the first page.

per_pageinteger

The number items to display on a page. Defaults to 100. Maximum is 500, if the value is greater that the maximum allowed it will fallback to 500.

Pagination options to navigate through the collection.

{
  "page": 3,
  "per_page": 10
}

include'recruitment_cycle'

The associated data for this resource.

Response

Collection of providers.

Example response

{
  "data": [
    {
      "id": "14554",
      "type": "providers",
      "attributes": {
        "city": "London",
        "county": "London",
        "changed_at": "2019-06-13T10:44:31Z",
        "code": "X99",
        "ukprn": "10071005",
        "urn": "115074",
        "created_at": "2019-06-13T10:44:31Z",
        "postcode": "SK2 6AA",
        "latitude": "51.498161",
        "longitude": "-0.129900",
        "telephone": "01834 80657",
        "email": "school@example.com",
        "name": "Long School",
        "provider_type": "scitt",
        "region_code": "south_west",
        "street_address_1": "Long College",
        "street_address_2": "1st floor, 86 Long Rd",
        "street_address_3": "Newington",
        "train_with_disability": "We are committed to supporting trainees with disabilities and other needs, so please let us and the accrediting provider know if you would like us to make any adjustments to support you.",
        "train_with_us": "We offer both primary and secondary training in a wide range of subjects and work with a collection of schools in the local area. We offer diverse teaching placements, ensuring trainees have experience in different types of school environments.",
        "website": "http://www.teamworkstsa.org/home-page-s-c-i-t-t-teacher-training/",
        "discarded_at": "2023-07-18T15:23:15Z",
        "selectable_school": true
      },
      "relationships": {
        "recruitment_cycle": {
          "data": {
            "type": "recruitment_cycles",
            "id": "3"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "3",
      "type": "recruitment_cycles",
      "attributes": {
        "year": 2021,
        "application_start_date": "2020-10-13",
        "application_end_date": "2021-10-03"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}