ILR specification: 2022 to 2023

Completion of Year of Instance: Field


This field refers to the year of programme of study being funded. The field records the learner's completion status with respect to that year of programme of study being funded.

Reason Required

Required by the OfS for alignment with definitions used for funding allocations. The definitions refer back to the OfS definitions so that, if in future there are any modifications to the OfS definitions, the ILR is able to accommodate them.

Schema Definitions

XML Entity Name
Field Length
Data type
Minimum occurrences
Maximum occurrences

Collection Requirements

  • Aim Types 3,4 and 5

Attribute Codes

Code Title
1 Completed the current year of programme of study
2 Did not complete the current year of programme of study
3 Year of programme of study not yet completed, but has not failed to complete
9 Not in HESES population


  • Coding should be consistent with the OfS HESES definitions, this is a different definition to that in the completion status field.

  • For full guidance about this field, please refer to the HESA specification.

  • Code 9, 'Not in HESES population'. This value can be used if the reporting period does not contain in part or in whole, a year of programme of study which has previously, is, or will be returned to HESES. However, providers can also use the other codes for such records.

  • Where a student undertakes a foundation degree and bridging course in the same HESES reporting year, this field should reflect whether the student completed the foundation degree and will therefore usually be returned with a value of 1. Similarly, where the student progresses to a degree after completion of the bridging course, this field should reflect the completion status of the degree.