Skip to main content
sdmx-dl
GitHub Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Inspect metadata

Look up descriptive metadata (title, units, notes, source-specific attributes) attached to a series or a flow, without downloading the observations themselves.

//JAVA 25+
//DEPS com.github.nbbrd.sdmx-dl:sdmx-dl-standalone:3.2.0
import sdmxdl.*;
import sdmxdl.web.SdmxWebManager;

void main() throws Exception {
    SdmxWebManager
            .ofServiceLoader()
            .usingName("ECB")
            .getData(DataRequest.builder()
                    .flowOf("EXR")
                    .keyOf("M.CHF.EUR.SP00.A")
                    .detailOf(Detail.NO_DATA.name())
                    .build())
            .forEach(series -> series.getMeta().forEach((concept, value) ->
                    IO.println(concept + " = " + value)));
}
sdmx-dl fetch meta ECB EXR M.CHF.EUR.SP00.A

GetData/GetDataStream accept the same detail parameter as the CLI/API; pass NO_DATA to get series-level metadata without downloading observations.

REST

curl -G localhost:4559/sdmx-dl/v2/ECB/EXR/data \
  --data-urlencode "key=M.CHF.EUR.SP00.A" \
  --data-urlencode "detail=NO_DATA"

gRPC

grpcurl -d '{"source":"ECB","flow":"EXR","key":"M.CHF.EUR.SP00.A","detail":"NO_DATA"}' -plaintext localhost:4557 sdmxdl.grpc.v2.SdmxWebManager.GetData

For flow-level metadata (dimensions, attributes, codelists) instead of series-level, use GetMeta:

curl "localhost:4559/sdmx-dl/v2/ECB/EXR/meta"
grpcurl -d '{"source":"ECB","flow":"EXR"}' -plaintext localhost:4557 sdmxdl.grpc.v2.SdmxWebManager.GetMeta

Notes

  • detail=NO_DATA is the series-level equivalent of the CLI’s fetch meta and the API’s Detail.NO_DATA: every flavor now shares the same request shape as Retrieve data, just with detail set to skip observations.
  • Don’t confuse this with flow/structure-level metadata (dimensions, attributes, codelists): that’s GetMeta/getMeta(...) on every flavor — see Browse dimensions and attributes.