Features
sdmx-dl Features documents one capability per page, with examples for each flavor:
- Java library (
API) - Command-line tool (
CLI) - Web service (
WS: REST + gRPC + MCP)
New here? Follow the steps below in order.
Most tasks follow the same three steps, regardless of the flavor you use.
Find the source and flow you want to query.
- Discover sources - See which data providers are available, or find one by name or topic.
- Discover databases - Find a database namespace within a source.
- Discover flows - List the datasets published by a source, or find one by topic.
Explore the flow’s structure and narrow down valid keys.
- Browse dimensions and attributes - List the components that make up a flow’s structure.
- Browse codes - Look up the labels behind a dimension’s codes.
- Browse availability - Narrow codes down to what’s actually available under a key.
Fetch metadata and observations for the key you’ve settled on.
- Inspect metadata - Look up descriptive metadata for a series or flow.
- Narrow your request - Restrict data to a date range and/or a limited number of observations.
- Retrieve data - Download observations for a source/flow/key.
These aren’t steps in the flow above - they apply throughout it, from the very first call to the last, whenever you run sdmx-dl reliably (interactively or unattended).
- Authentication and credentials - Configure access to protected sources, whenever a source needs it.
- Monitor and status - Check a source’s health before relying on it, at any point.
- Output and formats - Pick the right output shape per flavor, for any of the calls above.