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_d5ca66c3c2428e27d2562bcc6ea6be3bcad9609fbfa9cb89e691676c8690fd9c
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.	2025
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.	2025-09-14T11:34:56Z

Possible responses

HTTP 200 returns an array of training providers

{
  "data": [
    {
      "id": "7bcf4928-a0c7-4fa7-aa46-d4297eec31e0",
      "operating_name": "Higher education institution (HEI) 7320",
      "provider_type": "hei",
      "code": "8BN",
      "accreditation_status": "unaccredited",
      "ukprn": "77336264",
      "urn": null,
      "updated_at": "2025-09-15T11:34:56Z"
    },
    {
      "id": "bc668b2e-9fa2-4bda-a2f4-97f95d391cf8",
      "operating_name": "Higher education institution (HEI) 9494",
      "provider_type": "hei",
      "code": "7LA",
      "accreditation_status": "accredited",
      "ukprn": "80063525",
      "urn": null,
      "updated_at": "2025-09-15T11:34:56Z"
    },
    {
      "id": "e375bccb-26e8-4dba-a8bc-eca867da9e3b",
      "operating_name": "Other 7598",
      "provider_type": "other",
      "code": "95D",
      "accreditation_status": "unaccredited",
      "ukprn": "69846690",
      "urn": null,
      "updated_at": "2025-09-15T11:34:56Z"
    },
    {
      "id": "3c677f94-76cd-4e07-967e-3a6e78f961eb",
      "operating_name": "Other 9808",
      "provider_type": "other",
      "code": "3IU",
      "accreditation_status": "accredited",
      "ukprn": "17855396",
      "urn": null,
      "updated_at": "2025-09-15T11:34:56Z"
    },
    {
      "id": "44ea1b4b-e474-4334-930a-5a71eaa3547d",
      "operating_name": "School 5025",
      "provider_type": "school",
      "code": "FA9",
      "accreditation_status": "unaccredited",
      "ukprn": "24625549",
      "urn": "543380",
      "updated_at": "2025-09-15T11:34:56Z"
    },
    {
      "id": "03bfb99e-9e20-4715-9401-f346354fc1e4",
      "operating_name": "School-centred initial teacher training (SCITT) 7475",
      "provider_type": "scitt",
      "code": "PAZ",
      "accreditation_status": "accredited",
      "ukprn": "34400987",
      "urn": "443670",
      "updated_at": "2025-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[].id	string	true	The unique UUID identifier for the training provider.	7bcf4928-a0c7-4fa7-aa46-d4297eec31e0
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	true	The 6-digit Unique Reference Number for schools. This field can also be null.	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