Providers

Endpoint
Authentication
Query parameters
Possible response
Schema

Get many providers

Endpoint

GET /api/{api_version}/providers

Authentication

Send a bearer token from the API clients section:

Authorization: Bearer YOUR_TOKEN_VALUE

Tokens must be active, not revoked, and not expired.

Query parameters

Parameter	In	Type	Required	Description	Example
Authorization	header	string	true	A valid API token must be provided in the Authorization header to access this endpoint.	test_d27443581310a59525f0323fffe9412db849fec901beb840cb021c65b273f171
academic_year	query	integer	false	Filters providers by the specified academic year. The value must be a 4-digit year, for example 2025. If not provided, the API will return providers active in the current academic year.	2026
api_version	path	string	true	The API version to use in the request path. This should be set to the latest version for this endpoint.	v0
changed_since	query	string	false	Filters providers to only those updated after the specified timestamp. The value must be an ISO 8601 datetime, for example: 2025-09-14T11:34:56Z.	2026-09-14T11:34:56Z

Possible responses

HTTP 200 returns an array of training providers

{
  "data": [
    {
      "rotp_id": "RoTP-26C6QI09",
      "operating_name": "Higher education institution (HEI) 4270",
      "provider_type": "hei",
      "code": "LVI",
      "accreditation_status": "unaccredited",
      "ukprn": "66967363",
      "urn": "73040",
      "updated_at": "2026-09-15T11:34:56Z"
    },
    {
      "rotp_id": "RoTP-26D0IA09",
      "operating_name": "Higher education institution (HEI) 7244",
      "provider_type": "hei",
      "code": "IQX",
      "accreditation_status": "accredited",
      "ukprn": "29257567",
      "urn": "483494",
      "updated_at": "2026-09-15T11:34:56Z"
    },
    {
      "rotp_id": "RoTP-26K8HH09",
      "operating_name": "Other 4502",
      "provider_type": "other",
      "code": "1ZV",
      "accreditation_status": "unaccredited",
      "ukprn": "13681317",
      "urn": "396629",
      "updated_at": "2026-09-15T11:34:56Z"
    },
    {
      "rotp_id": "RoTP-26F9CK09",
      "operating_name": "Other 5710",
      "provider_type": "other",
      "code": "7BX",
      "accreditation_status": "accredited",
      "ukprn": "13858851",
      "urn": "98144",
      "updated_at": "2026-09-15T11:34:56Z"
    },
    {
      "rotp_id": "RoTP-26F1DI09",
      "operating_name": "School 6728",
      "provider_type": "school",
      "code": "JN8",
      "accreditation_status": "unaccredited",
      "ukprn": "88489798",
      "urn": "179880",
      "updated_at": "2026-09-15T11:34:56Z"
    },
    {
      "rotp_id": "RoTP-26K4CJ09",
      "operating_name": "School-centred initial teacher training (SCITT) 3180",
      "provider_type": "scitt",
      "code": "HT4",
      "accreditation_status": "accredited",
      "ukprn": "19407537",
      "urn": null,
      "updated_at": "2026-09-15T11:34:56Z"
    },
    {
      "rotp_id": "RoTP-26V5XY09",
      "operating_name": "School-centred initial teacher training (SCITT) 6787",
      "provider_type": "scitt",
      "code": "O3Y",
      "accreditation_status": "accredited",
      "ukprn": "82228738",
      "urn": "577270",
      "updated_at": "2026-09-15T11:34:56Z"
    }
  ]
}

HTTP 401 returns 401 Unauthorized for invalid token

{
  "error": "Unauthorized"
}

Schema

Field	Type	Required	Description	Example
data	array	true	An array of training provider objects matching the specified filters.
data[].operating_name	string	true	The primary business or operating name of the training provider.	Bobby Jacob University
data[].provider_type	string	true	The classification of the provider. Possible values: hei scitt school other	hei
data[].code	string	true	The unique 3-character identifier code for the provider.	1BJ
data[].accreditation_status	string	true	The current accreditation status of the provider. Possible values: accredited unaccredited	accredited
data[].ukprn	string	true	The 8-digit UK Provider Reference Number.	77336264
data[].urn	["string", "null"]	true	The 5 or 6 digit Unique Reference Number. Optional for all provider types; returned as null when no URN is recorded.	543380
data[].updated_at	string	true	The ISO 8601 timestamp of when the provider record was last modified. This field will be in the format date-time.	2025-09-15T11:34:56Z
data[].rotp_id	["string", "null"]	false	The unique Register of training provider identifier.	RoTP-00A0BC00