---
title: "Returns a list of providers suggestions matching the query term."
method: GET
path: "/provider_suggestions"
tags: ["provider_suggestions"]
---

# Returns a list of providers suggestions matching the query term.

`GET /provider_suggestions`

## Request

- Base URL: `https://api.publish-teacher-training-courses.service.gov.uk/api/public/v1`
- URL: `https://api.publish-teacher-training-courses.service.gov.uk/api/public/v1/provider_suggestions`
- Auth: none declared

## Query parameters

- `query` string, required

## Response `200`

A list of provider suggestions matching the query term

- ProviderSuggestionListResponse: This schema is used to return a collection of provider suggestions.
  - `data` ProviderSuggestion[], required
    - `id` string
    - `type` string
    - `attributes` ProviderSuggestionAttributes: This schema is used to describe a provider's lookup information.
      - `name` string
      - `code` string
  - `jsonapi` JSONAPI: This returns the version of JSON API in use.
    - `version` string, required

## Other responses

- `400`: A bad request

## Changes

- **2021-01-27** `074297e2142c`: 2 warning, 3 info
  - removed the optional property `data/items/code` from the response with the `200` status
  - removed the optional property `data/items/name` from the response with the `200` status
  - added the optional property `data/items/attributes` to the response with the `200` status
  - added the optional property `data/items/id` to the response with the `200` status
  - …1 more
- **2021-01-26** `67e7eefbc146`: 3 warning, 2 info
  - removed the optional property `data/items/attributes` from the response with the `200` status
  - removed the optional property `data/items/id` from the response with the `200` status
  - removed the optional property `data/items/type` from the response with the `200` status
  - added the optional property `data/items/code` to the response with the `200` status
  - …1 more
- **2021-01-26** `da5815f1a537`: 2 warning, 3 info
  - removed the optional property `data/items/code` from the response with the `200` status
  - removed the optional property `data/items/name` from the response with the `200` status
  - added the optional property `data/items/attributes` to the response with the `200` status
  - added the optional property `data/items/id` to the response with the `200` status
  - …1 more
- **2021-01-25** `023bcb20febe`: 1 info
  - added the non-success response with the status `400`
- **2021-01-15** `640cc388a4ca`: 1 info
  - removed the non-success response with the status `400`

[Operation history](https://skmtc.dev/department-for-education/apis/teacher-training-courses-api/changes/provider_suggestions/get.md)

---

[API](https://skmtc.dev/department-for-education/apis/teacher-training-courses-api.md) - [All operations](https://skmtc.dev/department-for-education/apis/teacher-training-courses-api/llms.txt) - [OpenAPI document](https://skmtc.dev/department-for-education/apis/teacher-training-courses-api/revisions/4e9e8f725299?raw)