The SDMX initiative sets standards to facilitate the exchange of statistical data and metadata using modern information technology. Several versions of the technical specifications have been released since 2004. SDMX has also been published as an ISO International Standard (ISO 17369).
SDMX 3.0 Technical Specifications
The SDMX 3.0 Technical Specifications were released in September 2021.
Summary of Changes and New Functionalities.. Summary of the major changes between version 2.1 and version 3.0.
Section 1 – Framework. Introduces the documents and the content of version 3.0.
Section 2 – Information Model. UML model and functional description, definition of classes, associations and attributes.
Section 5 – Registry Specification – Logical Interfaces. Provides the specification for the logical registry interfaces, including subscription/notification and registration of data.
Section 6 – Technical Notes.. Provides technical information for implementors.
The following sections are published on the SDMX TWG official GitHub repository.
REST API. The RESTful web services application programming interface specification (GitHub).
SDMX-ML. XML format specifications for exchanging structures, data and reference metadata (GitHub).
SDMX-JSON. JSON format specifications for exchanging structures, data and reference metadata (GitHub).
SDMX-CSV. CSV format specifications for exchanging data and reference metadata (GitHub).
The following sections are obsolete:
Section 3 – SDMX-ML – replaced by the sdmx-twg/sdmx-ml GitHub repository
Section 4 – SDMX-EDI deprecated in version 3.0
Section 7 – API – replaced by the sdmx-twg/sdmx-rest GitHub repository
SDMX 2.1 Technical Specifications – Consolidated version 2020
These are the current SDMX 2.1 Technical Specifications. Minor errors and inconsistencies were corrected in August 2011 and May 2012. The Technical Notes and the Web Services Guidelines were also amended in March and April 2013. In July 2020, the specifications have been upgraded for the adoption of the VTL 2.0.
Section 1 – Framework. Introduces the documents and the content of the revised Version 2.1 (UPDATE 7/2020)
Section 2 – Information Model. UML model and functional description, definition of classes, associations and attributes (UPDATE 7/2020)
Section 3A – SDMX-ML. Specifies and documents the XML formats for describing structure, data, reference metadata, and interfaces to the registry (UPDATE 7/2020)
Section 3B – SDMX-ML. XML schemas, samples, WADL and WSDL (UPDATE 7/2020)
Section 4 – SDMX-EDI. Specifies and documents the UN/EDIFACT format for describing structure and data
Section 5 – Registry Specification – Logical Interfaces. Provides the specification for the logical registry interfaces, including subscription/notification, registration of data and metadata, submission of structural metadata, and querying (UPDATE 7/2020)
Section 6 – Technical Notes. Provides some technical information which may be useful for the implementation (this was called the “Implementor’s Guide” in the 2.0 release) (UPDATE 7/2020)
The following sections are published on the SDMX TWG official GitHub repository.
Section 7 – Web Services Guidelines.
The REST API specifications can be found at https://github.com/sdmx-twg/sdmx-rest/tree/v1.5.0 .
The SOAP API specifications can be found at https://github.com/sdmx-twg/sdmx-soap.
SDMX-JSON. JSON format specifications for exchanging structures and data can be found at https://github.com/sdmx-twg/sdmx-json/tree/v1.0 .
SDMX-CSV. CSV format specifications for exchanging data can be found at https://github.com/sdmx-twg/sdmx-csv/tree/v1.0 .
Other material
- Summary of Changes and New Functionalities. Document highlighting some of the major changes from the previous version.
- Disposition Log. Log of comments resulting from the public review for SDMX 2.1.
- SDMX-CSV format specifications: SDMX-CSV Data Message is an SDMX data exchange format based on the RFC 4180. CSV is a widely used standardised and simple format to exchange data supported by many tools.
- SDMX-JSON standard: The SDMX-JSON standard is a JSON (JavaScript Object Notation) based data exchange message format designed for and therefore responding to the main use case of data discovery and visualisation on the web. The proposed format conforms to the JSON standard specification.
The following further material is made available to implementers:
- Validation and Transformation Language (VTL): these technical specifications have been released to implement a specific section of the SDMX Information Model.
SDMX 2.0 Technical Specifications
SDMX Technical Standards Version 2.0 provide the technical specifications for the exchange of data and metadata based on a common information model. The scope of this work is to define formats for the exchange of aggregated statistical data and the metadata needed to understand how the data is structured. The major focus is on data presented as time series, although cross-sectional XML formats are also supported.
Version 2.0 Technical Standards are backward compatible with the earlier Version 1.0 work, which focused on XML- and EDIFACT-syntax data formats. The latest work broadens the technical framework to support wider coverage of metadata exchange as well as a more detailed architecture for data and metadata exchange.
These specifications have been developed, reviewed, and adopted by SDMX. Steps will be taken to bring this work forward within the context of the International Standards Organisation (ISO), with a view to updating ISO/Technical Specification 17369:2005 SDMX.
SDMX 1.0 Technical Specifications
The SDMX Standards Version 1.0 provide the technical specification for a set of XML and EDIFACT syntax data formats based on a common information model. The scope of this work is to define formats for the exchange of aggregated statistical data and the metadata needed to understand how the data is structured. The major focus is on data presented as time series, although cross-sectional XML formats are also supported.
These specifications have been developed, reviewed, and adopted by SDMX. In due course they will be put forward to the International Standards Organisation (ISO) for adoption.
This page is maintained by the SDMX Technical Working Group (TWG) comprising members from central banks, statistical offices and international organisations. The TWG uses Github for the maintenance and development of the SDMX Technical Standards. For more information, see the TWG page on Github at https://github.com/sdmx-twg.
- For enquiries about the SDMX Technical Standards: [email protected]
- To connect with SDMX users and experts: https://www.yammer.com/unstats