Skip to main content
GOV.UK
Register trainee teachers
Beta
Menu
API
CSV
Reference data
Help
Table of contents
Search (via Google)
Search
Register API documentation
What this API is for
How do I connect to this API?
Authentication and authorisation
Design principles
Trainee identifiers
Reference data and data encoding
Dates
Nationalities
Degrees
Placements
API versioning strategy
Breaking changes
Non-breaking changes
How the API version number reflects the changes we’ve made
Using the correct version of the API
Testing
Release notes
v2026.0 — 30 January 2026
Changes
v2025.0 — 1 September 2025
Changes
v1.0-pre — 12 August 2024
Changes
v0.1 — 22 April 2024
Known issues
v2026.0
Contents
API versioning strategy
Developing on the API
OpenAPI
Authentication
Rate Limiting
Enhanced Errors
Scope
Usage
Response Format
Endpoints
GET /info
Request
Possible responses
GET /trainees
Request
Parameters
Possible responses
GET /trainees/{trainee_id}
Request
Parameters
Possible responses
GET /trainees/{trainee_id}/placements
Request
Parameters
Possible responses
GET /trainees/{trainee_id}/placements/{placement_id}
Request
Parameters
Possible responses
GET /trainees/{trainee_id}/degrees
Request
Parameters
Possible responses
GET /trainees/{trainee_id}/degrees/{degree_id}
Request
Parameters
Possible responses
POST /trainees
Request
Request body
Possible responses
Trainee duplication validations
POST /trainees/{trainee_id}/placements
Request
Parameters
Request body
Possible responses
POST /trainees/{trainee_id}/degrees
Request
Parameters
Request body
Possible responses
Degree duplication validations
POST /trainees/{trainee_id}/recommend-for-qts
Request
Parameters
Request body
Possible responses
POST /trainees/{trainee_id}/defer
Request
Parameters
Request body
Possible responses
POST /trainees/{trainee_id}/withdraw
Request
Parameters
Request body
Possible responses
PUT|PATCH /trainees/{trainee_id}
Request
Parameters
Request body
Possible responses
PUT|PATCH /trainees/{trainee_id}/placements/{placement_id}
Request
Parameters
Request body
Possible responses
PUT|PATCH /trainees/{trainee_id}/degrees/{degree_id}
Request
Parameters
Request body
Possible responses
Degree duplication validations
DELETE /trainees/{trainee_id}/placements/{placement_id}
Request
Parameters
Possible responses
DELETE /trainees/{trainee_id}/degrees/{degree_id}
Request
Parameters
Possible responses
Objects
Trainee object
Placement object
Degree object
Field lengths summary
v2025.0
Contents
API versioning strategy
Developing on the API
OpenAPI
Authentication
Rate Limiting
Enhanced Errors
Scope
Usage
Response Format
Endpoints
GET /info
Request
Possible responses
GET /trainees
Request
Parameters
Possible responses
GET /trainees/{trainee_id}
Request
Parameters
Possible responses
GET /trainees/{trainee_id}/placements
Request
Parameters
Possible responses
GET /trainees/{trainee_id}/placements/{placement_id}
Request
Parameters
Possible responses
GET /trainees/{trainee_id}/degrees
Request
Parameters
Possible responses
GET /trainees/{trainee_id}/degrees/{degree_id}
Request
Parameters
Possible responses
POST /trainees
Request
Request body
Possible responses
Trainee duplication validations
POST /trainees/{trainee_id}/placements
Request
Parameters
Request body
Possible responses
POST /trainees/{trainee_id}/degrees
Request
Parameters
Request body
Possible responses
Degree duplication validations
POST /trainees/{trainee_id}/recommend-for-qts
Request
Parameters
Request body
Possible responses
POST /trainees/{trainee_id}/defer
Request
Parameters
Request body
Possible responses
POST /trainees/{trainee_id}/withdraw
Request
Parameters
Request body
Possible responses
PUT|PATCH /trainees/{trainee_id}
Request
Parameters
Request body
Possible responses
PUT|PATCH /trainees/{trainee_id}/placements/{placement_id}
Request
Parameters
Request body
Possible responses
PUT|PATCH /trainees/{trainee_id}/degrees/{degree_id}
Request
Parameters
Request body
Possible responses
Degree duplication validations
DELETE /trainees/{trainee_id}/placements/{placement_id}
Request
Parameters
Possible responses
DELETE /trainees/{trainee_id}/degrees/{degree_id}
Request
Parameters
Possible responses
Objects
Trainee object
Placement object
Degree object
Field lengths summary
v1.0-pre - API Version Removed
What happened?
What should I do?
v0.1 - API Version Removed
What happened?
What should I do?
Objects
!
Warning
The v2026.0 version is currently available for testing in the sandbox environment only. It is not yet available in production.