parsimony-destatis

Destatis (German Federal Statistical Office) connector — fetches and enumerates tables from the public GENESIS-Online REST API.

Part of the parsimony-connectors monorepo. Distributed standalone on PyPI as parsimony-destatis.

Connectors

Coverage

The keyless GENESIS-Online REST API exposes 3,009 predefined tables across 331 statistics (prices, population, national accounts, labour, foreign trade, production, transport, health, environment, earnings, …). enumerate_destatis walks the authoritative path — /statistics then a per-statistic /tables fan-out — which is lossless (every statistic's table list comes back in full, no pagination cap, no table shared across statistics), so the catalog contains every fetchable table. Each table is itself multi-dimensional: destatis_fetch returns one row per (classification combination × period), with the classification dimensions preserved as columns. Time is parsed from the JSON-stat period keys (annual, monthly, quarterly, semester, reference-date, school-year — all normalized to ISO dates).

The multidimensional cube / custom-table power-user surface of classic GENESIS is not part of this keyless API (it belonged to the retired registration-gated webservice) and is out of scope.

Install

pip install parsimony-destatis

Pulls in a compatible parsimony automatically. Verify discovery:

python -c "from parsimony import discover; print([p.name for p in discover.iter_providers()])"

Configuration

No credentials required. GENESIS-Online allows anonymous access — there is no API key, username, or password to set.

The only optional setting is the catalog-snapshot URL used by destatis_search:

export PARSIMONY_DESTATIS_CATALOG_URL="hf://your-org/destatis"   # optional; overrides the default snapshot

Quick start

from parsimony_destatis import CONNECTORS

result = CONNECTORS["destatis_fetch"](name="61111-0001")
print(result.raw.head())

For multi-plugin composition:

from parsimony import discover

connectors = discover.load_all()

Provider

• Homepage: https://www.destatis.de
• GENESIS-Online API: https://genesis.destatis.de/genesis/api/rest

License

See LICENSE.