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:

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.