---
id: sdmx1
version: "2.27.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# sdmx1 — Statistical Data and Metadata eXchange (SDMX)

License: permissive · Maintenance: active · Downloads: 209.9K/mo

## What it is and what it does

sdmx1 is a Python implementation of the SDMX 2.1 and 3.0 standards for statistical data and metadata exchange. It lets you retrieve data from SDMX-REST web services operated by organizations like the World Bank, IMF, Eurostat, OECD, and UN, then read, write, and convert that data in SDMX-ML (XML), SDMX-JSON, and SDMX-CSV formats. The package integrates tightly with pandas, allowing you to transform SDMX data into DataFrames for use with the broader Python data science ecosystem.

The package is built on six runtime dependencies—lxml for XML handling, pandas for data structures, requests for HTTP access, packaging for version management, python-dateutil for date parsing, and platformdirs for configuration storage. It targets Python 3.10 and later and is actively maintained, with a release cycle measured in days.

Use it for:

- Retrieve economic or financial data from World Bank, IMF, or Eurostat SDMX services and load directly into pandas for analysis.
- Convert SDMX-formatted files (XML, JSON, CSV) into pandas DataFrames for statistical processing.
- Publish your own statistical datasets using the SDMX information model for interoperability with other agencies.
- Automate data pipelines that fetch and transform SDMX data from multiple international statistical providers.
- Read and validate SDMX metadata structures to understand data definitions and hierarchies.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Reads, writes, and exchanges statistical data and metadata in SDMX formats (XML, JSON, CSV) and integrates with pandas for analysis.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and solves a real problem for anyone working with international statistical data standards. The permissive Apache 2.0 license poses no barrier. Install if you need to exchange data with SDMX-compliant services or work with SDMX-formatted files.

## Install

pip install sdmx1
uv add sdmx1
poetry add sdmx1

## Installing sdmx1

Before you install: Low friction install with six common dependencies (lxml, pandas, requests, packaging, python-dateutil, platformdirs). Active maintenance with a release 7 days ago.

License in practice: Licensed under Apache License 2.0 (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install sdmx1

import sdmx
from sdmx import Request

req = Request('WB')
data = req.data('NY_GDP_MKTP_CD')
df = data.to_pandas()

Requires Python 3.10 or later.

Verify before relying:

- Whether the package supports all SDMX 2.1 and 3.0 features or a subset of the standards
- Performance characteristics when working with large datasets or many REST endpoints

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 209.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

SDMX data exchange, statistical metadata standards, SDMX REST web services, SDMX to pandas conversion, ISO 17369 implementation, statistical data formats, SDMX file parsing, data-exchange, statistical-standards, international-data

[View on SkillFed](https://skillfed.io/packages/sdmx1) · [View on PyPI](https://pypi.org/project/sdmx1/)