ILR specification: 2026 to 2027

Agreement identifier: Field

Updates

Version 1 View changes

Definition

The identifier to associate an ILR record to an employer organisation in the apprenticeship service..

Reason Required

To enable the association of an ILR record to an employer organisation in the apprenticeship service during the approvals process.

Schema Definitions

XML Entity Name
AgreemId
Field Length
7
Data type
RestrictedString
Minimum occurrences
0
Maximum occurrences
1

Collection Requirements

  • Apprenticeships (FundModel 36)
  • Growth and Skills Short Course Offer (FundModel 39)

Pattern

[A-Za-z0-9]{1,7}

Notes

  • The Agreement ID can be found in the ‘View employers and manage permissions’ section of the Apprenticeship Service account.

  • This field should be recorded for all learners who are enrolled on an apprenticeship funded programme where the provider has a relationship with the employer in their apprenticeship account.

  • This field is returned on the employment status record with the start date of the apprenticeship programme. If the agreement ID changes through the lifetime of the programme a new status record must be added with the changed agreement ID. For example, if the employer changes.

  • The Agreement ID must belong to the employer in the apprenticeship account funding the learning .

  • This is not an employer’s account ID