Skip to main content
Creating a new NHS England: NHS England and NHS Digital will merge on 1 February 2023. Learn more.

Creating a baseline

Find out about creating a baseline, including information on full files, archive files and usage.


Image of baseline and running operation overview

The Organisation Data Service (ODS) release two XML files of organisation data:

  • full file: HSCOrgRefData_Full_yyyymmdd.xml
  • archive file: HSCOrgRefData_Archive_yyyymmdd.xml

These files are available monthly to download from the Technology Reference data Update Distribution (TRUD) service. From these files a local baseline of organisation data can be created, which can then be updated on a daily basis by connecting to the ODS ORD API.

Full file

A single consolidated XML file containing all records of current interest (records that were open after the date currently enforced as the cut-off for the archive file), regardless of their Primary Role (such as all organisation types included) or when they were last changed.

It includes all the supporting information required to interpret the data within the manifest.

Archive file

Closed records are appended to a separate archive file periodically, in order to maintain the efficiency of the full file by keeping it as small as possible. Archiving a record (based on its closure before a certain date) will override any of the other criteria for inclusion in a file. The archive file follows exactly the same schema as the full file so there is only one universal schema. Each time an archiving event is triggered, a cut-off date is defined. Everything with an operational close date that falls before the most recently defined cut-off is published in the archive product, instead of the full file.

Further information can be found in the XML products guide.


Image of endpoint diagram

Last edited: 15 July 2021 12:42 pm