Providers

Contents

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_c25f336f7383819188fa488a20cfc3354a235d35ff9d4e5f18b03fe4b5e2ae53
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": "78a6a325-1d94-47bd-a626-05d7590ee088",
      "operating_name": "Higher education institution (HEI) 9474",
      "provider_type": "hei",
      "code": "6OC",
      "accreditation_status": "accredited",
      "updated_at": "2025-09-15T11:34:56Z"
    }
  ]
}

HTTP 401 returns 401 Unauthorized for invalid token

{
  "error": "Unauthorized"
}