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
  1. sdmx-dl
  2. /
  3. Features
  4. /
  5. Browse codes

Browse codes

Look up the human-readable labels behind a coded dimension’s values (e.g. FREQ=M means “Monthly”), so you can build a valid key or interpret one.

//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")
            .listCodes(CodesRequest.builder()
                    .flowOf("EXR")
                    .concept("FREQ")
                    .build())
            .forEach((code, label) -> IO.println(code + " = " + label));
}

listCodes resolves the codes of a chosen concept; it accepts an optional query/maxResults to search/limit results, the same way as Browse dimensions and attributes.

sdmx-dl list codes ECB EXR FREQ

REST 

curl "localhost:4559/sdmx-dl/v2/ECB/EXR/codes/FREQ"

gRPC 

grpcurl -d '{"source":"ECB","flow":"EXR","concept":"FREQ"}' -plaintext localhost:4557 sdmxdl.grpc.v2.SdmxWebManager.ListCodes

Notes

  • This lists all defined codes for a dimension, regardless of whether they actually occur in the dataset. To narrow codes down to what’s actually available under a key constraint, use Browse availability instead.
  • CLI has a dedicated list codes command; the API offers the equivalent Provider.listCodes(...); WS exposes it as the ListCodes RPC//codes/{dimension} REST endpoint (its concept field on gRPC is the same value as the REST path segment).
  • To find out which dimension/concept names are available for a flow first, see Browse dimensions and attributes.
gdoc_arrow_left_alt Browse dimensions and attributes Browse availability gdoc_arrow_right_alt