Apprentice Data Explained ​

The following is a list of data fields returned by the ACE360 Connect apprentice and apprentices endpoints. We've written this reference guide to help you better understand the data you receive from Connect.

Contents ​

• Id
• FirstName
• LastName
• UlnNumber
• DateOfBirth
• Gender
• EthnicGroup
• StandardId
• Status
• TpoId
• EpaOverallGrade
• EpaProvisionalGrade
• EpaoRegisteredDate
• EstimatedStartDate
• EstimatedEndDate
• EstimatedGatewayAtEpaoRegistration
• EsfaCertificateClaimedAt
• EpaoNotes
• CreatedAt
• ArchivedAt
• GradeDate
• ApprovedForEpaDate
• EpaoInternalId
• ArchivalStatus
• ReasonableAdjustmentRequestedAt
• ReasonableAdjustmentApprovedAt
• ReasonableAdjustmentRejectedAt

id ​

Example:

"id": 249

This is the unique identifier for an apprentice in ACE360. Commonly referred to as an ACE ID.

firstName ​

Example:

"firstName": "Lucy"

The first name of an apprentice.

lastName ​

Example:

"lastName": "Smith"

The last name of an apprentice.

ulnNumber ​

Example:

"ulnNumber": "3000600342"

An apprentice's unique learner number.

dateOfBirth ​

Example:

"dateOfBirth": "2010-02-19"

An apprentice's date of birth.

gender ​

Example:

"gender": "Female"

An apprentice's gender.

ethnicGroup ​

Example:

"ethnicGroup": "English/Welsh/Scottish/Northern Irish/British"

An apprentice's ethnic group.

standardId ​

Example:

"standardId": 204

The standard an apprentice is on. You will be able to use this id to get standard information from our standards endpoint.

status ​

Example:

"status": {
"id": 3,
"text": "Gateway Evidence Complete"
}

The current status of an apprentice in ACE360.

The list of statuses are:

1	In Training
2	Gateway in Progress
3	Gateway Evidence Complete
4	Gateway Submitted
5	Approved for EPA
6	Denied EPA
7	EPA in Progress
8	EPA Evidence Complete
9	EPA Passed
10	EPA Failed

tpoId ​

Example:

"tpoId": 57

The ID of the TPO the apprentice is associated with. Can be used to fetch more information from the TPOs endpoint.

epaOverallGrade ​

Example:

"epaOverallGrade": "pass"

The overall grade an apprentice achieved at the end of EPA.

epaProvisionalGrade ​

Example:

"epaProvisionalGrade": "merit"

The provisional grade an apprentice was assigned at the end of EPA.

epaoRegisteredDate ​

Example:

"epaoRegisteredDate": "2023-12-12"

This is the date when an EPAO is assigned to an apprentice.

estimatedStartDate ​

Example:

"estimatedStartDate": "2023-10-23"

This is the apprenticeship start date of the apprentice as determined by the training providor. Should match the ILR return of the training provider.

estimatedEndDate ​

Example:

"estimatedEndDate": "2028-01-29"

This is the date at which the apprentice is expected to reach gateway.

estimatedGatewayAtEpaoRegistration ​

Example:

"estimatedGatewayAtEpaoRegistration": "2024-03-06 00:00:00"

Expected gateway date at the point of registration with the EPAO.

esfaCertificateClaimedAt ​

Example:

"esfaCertificateClaimedAt": "2022-10-22 17:18:39"

Date at which an apprentice’s certificate reference is claimed from the ESFA.

epaoNotes ​

Example:

"epaoNotes": "These is a example EPAO note"

These are notes attached to the apprentice which are only visible to the EPAO.

createdAt ​

Example:

"createdAt": "2023-10-23 07:08:38"

Date when the record was created.

archivedAt ​

Example:

"archivedAt": "2023-11-06 14:40:32"

Date at which the record has been archived (only old records will have this).

gradeDate ​

Example:

"gradeDate": "2023-10-31 12:33:59"

Date at which an apprentice received their final grade.

approvedForEpaDate ​

Example:

"approvedForEpaDate": "2023-10-31 12:33:59"

Date at which the epao has approved the gateway submitted by the training provider.

epaoInternalId ​

Example:

"epaoInternalId": "epao_internal_id_123"

This field is only visible to EPAOs.

archivalStatus ​

Example:

"archivalStatus": "auto_archived"

This field corresponds to an apprentice's archival status and has 5 possible values:

"withdrawn"
"break_in_learning"
"auto_archived"
"archived"
null

reasonableAdjustmentRequestedAt ​

Example:

"reasonableAdjustmentRequestedAt": "2024-07-22 12:00:43"

Date at which the training provider requested a reasonable adjustment.

reasonableAdjustmentApprovedAt ​

Example:

"reasonableAdjustmentApprovedAt": "2024-07-22 12:00:43"

Date at which the epao approved the reasonable adjustment.

reasonableAdjustmentRejectedAt ​

Example:

"reasonableAdjustmentRejectedAt": "2024-07-22 12:00:43"

Date at which the epao rejected the reasonable adjustment.