Overview

The recruitment API allows consumers to create and manage apprenticeship vacancies to the Find an Apprenticeship service. It is typically used by those working with either employers to support them in getting their vacancy live, or providers to help them advertise vacancies for which they are providing the apprenticeship training.

Documents

document.json
Uploaded schema

Who can use this API

The API is primarily targeted at employers and apprenticeship training providers. It cannot be accessed by anyone not affiliated with these groups as it requires keys to be generated by either a registered employer or provider to post vacancies on their behalf.

Instructions for how to subscribe to this API are available here: https://developer.apprenticeships.education.gov.uk/

Technologies

C#; JSON; RESTful

Current release

Release name Available from
1 24 August 2026

Operations

GET GET list of Account Legal Entities.

Description

Get a list of Account Legal Entities that are connected to your subscription. The AccountLegalEntityPublicHashedId is required for Vacancy creation. If you are a provider only Accounts that have given permission for you to act on there behalf will show in the list. If you are an employer then only legal entities that have a signed agreement will be in the list.

URL template
/accountlegalentities

GET GET list of candidate skills.

Description

Returns list of candidate skills to be used when creating a Vacancy.

URL template
/referencedata/skills

GET GET list of courses.

Description

Returns list of courses to be used when creating a Vacancy. The Id should be used for standardsLarsCode in create Vacancy

URL template
/referencedata/courses

GET GET list of qualifications.

Description

Returns list of qualifications to be used when creating a Vacancy.

URL template
/referencedata/qualifications

POST POST apprenticeship vacancy

Description

Creates an apprenticeship vacancy using the specified values

URL template
/vacancy/{id}
Back to top