Skip to main content

XML Organisation Data Products

This page contains background information and a range of supporting materials for the XML Organisation Reference Data Products.

ANANA XML Test Dataset now available – September 2019

From 1 April 2020 onwards new organisation codes will conform to a single uniform structure of five alternating alphabetic and numeric characters with a format of ANANA. 

Please refer to detailed guidance on this change at our information portal.  An XML dataset including representative ANANA codes covering all organisation types in scope is now available for consumers to use for testing and assurance purposes. The content is based on the August 2019 data release. A spreadsheet containing the ANANA codes which appear in the data is also available below. 

Please read our products guide before accessing any of the other files.

The move to XML is one part of a wider programme of changes to Organisation Reference Data. Full details are available within an Information Standard.

The standard has been updated to inform consumers that daily updates to the Health and Social Care Organisation Reference Data are now available via Application Programming Interfaces (APIs) – please see APIs for the Organisation data Service.

XML products

Version information

Release item Full live file Archive file
Schema version 2-0-0 2-0-0
Publication date 30 April 2020 30 April 2020
Publication sequence number 817 816
File name HSCOrgRefData_Full_20200727      HSCOrgRefData_Archive 20200727  

XML files are only available to download from TRUD under the 'Organisation Data Services and Spine Directory Service' download group.

TRUD Pack In zip Contains file(s)
HSCOrgRefDataXML_Data fullfile.zip HSCOrgRefData_Full_yyyymmdd.xml
archive.zip HSCOrgRefData_Archive_yyyymmdd.xml

XML support products

In zip File(s) Version date
  HSCOrgRefData_Technical Specification 27 September 2017
refmodel HSCOrgRefData_ObjectModel
*Please read the README.txt file within the zip before opening the model*
28 February 2019
ancillary HSCOrgRefData_XMLProductScopeTimetable.pdf 29 April 2020  
  HSCOrgRefData.xsd 19 May 2017
  HSCOrgRefData_DataItemCatalogue.pdf 29 April 2020
  HSCOrgRefData_ChangeLog_DICandObjModel.pdf 29 April 2020
  XMLRelationshipRules.xlsx  29 April 2020

The ORD scope definition shows organisation types which will transition to ANANA code formats, and csv files which will be deprecated as the content is available via ORD (in XML or JSON format via the ORD API).

XML support tools

In zip File(s) Version date
validate Schemavalidator (folder) 15 February 2017
  HCSOrgRefData_ValidatorSupportDocumentation.pdf 15 February 2017
transform HSCOrgRefData_xslt (zip)
Contains the following transforms:
  • XML to CSV
  • Primary Role Constrain
  • **NEW** XMLtoCSV_database_schema_DDL 

Java and .NET platforms are now supported for the above transforms

30 November 2018
  HSCOrgRefData_XMLtoCSVSupportDocumentation.pdf 30 November 2018
  HSCOrgRefData_PrimaryRoleConstrainSupportDocumentation.pdf 28 September 2018


The XML support products and tools are also available to download via TRUD, within pack HSCOrgRefDataXML_Support.

Last edited: 30 April 2020 12:20 pm