Data Specification for Work-based – Data System Refresh Programme

Ngā whakatakotoranga raraunga – hōtaka Tāmata Pūnaha Raraunga

Last updated 26 June 2025
Last updated 26 June 2025

This page provides information about the data required for reporting Work-based delivery (Actuals) on DXP Ngā Kete.

Key dates for transition

We have re-aligned readiness and cutover dates to the new Work-based APIs' go-live date of 4 August 2025. Key dates are:

  • 18 July: TEO/Vendors confirm readiness.
  • 25 July 5pm: Stop ITR and DXP pre-prod.
  • 30 July 1pm: Release data migration reconciliations to TEOs.
  • 4 August: New Work-based APIs go live for all.

The Data Specification for Work-based

Work-based Data Specification (v1.1) (DOCX 1.3 MB) – updated 29 May 2025

A full change log is provided in Appendix B of the Work-based Data Specification.

Collection of learner fees via .CSV file upload

DXP Ngā Kete supports collection of fees via the API or via the .CSV file upload. 

Work-based Learner Fees (CSV 376 bytes) 

Reference data for Work-based

The reference data lists values for specific fields referred to in the Data Specifications. Reference data will be aligned to the Stats NZ definitions (where possible). 

DXP Data Classifications Appendices (v1.3) (XLSX 300 KB) – updated 24 April 2025

A full change log is provided in the Version Changes tab of the DXP Data Classifications Appendices.

Frequently asked questions and other guidance

Transition to new data requirements (DOCX 173 KB)

Work-based frequently asked questions (DOCX 32 KB)

Off-job delivery data frequently asked questions and guidance (DOCX 41 KB)