---
title: "Get codelists"
method: GET
path: "/codelist/{agencyID}/{resourceID}/{version}"
tags: ["Structure queries"]
---

# Get codelists

`GET /codelist/{agencyID}/{resourceID}/{version}`

## Request

- Base URL: `https://sdw-wsrest.ecb.europa.eu/service`
- URL: `https://sdw-wsrest.ecb.europa.eu/service/codelist/{agencyID}/{resourceID}/{version}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/oecd/apis/sdmx-restful-api-v1-5-0/docs/codelist/:agencyID/:resourceID/:version/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `agencyID` string, required
- `resourceID` string, required
- `version` string, required

## Query parameters

- `references` 'none' | 'parents' | 'parentsandsiblings' | 'children' | 'descendants' | 'all' | 'datastructure' | 'metadatastructure' | 'categoryscheme' | 'conceptscheme' | 'codelist' | 'hierarchicalcodelist' | 'organisationscheme' | 'agencyscheme' | 'dataproviderscheme' | 'dataconsumerscheme' | 'organisationunitscheme' | 'dataflow' | 'metadataflow' | 'reportingtaxonomy' | 'provisionagreement' | 'structureset' | 'process' | 'categorisation' | 'contentconstraint' | 'actualconstraint' | 'allowedconstraint' | 'attachmentconstraint' | 'transformationscheme' | 'rulesetscheme' | 'userdefinedoperatorscheme' | 'customtypescheme' | 'namepersonalisationscheme' | 'namealiasscheme'
- `detail` 'allstubs' | 'referencestubs' | 'referencepartial' | 'allcompletestubs' | 'referencecompletestubs' | 'full'

## Headers

- `Accept-Encoding` 'br' | 'compress' | 'deflate' | 'exi' | 'gzip' | 'identity' | 'pack200-gzip' | 'zstd'
- `Accept-Language` string
- `If-Modified-Since` string, date-time

## Response `200`

OK

- string

## Other responses

- `304`: No changes
- `400`: Bad syntax
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `406`: Not acceptable
- `413`: Request entity too large
- `414`: URI too long
- `500`: Internal server error
- `501`: Not implemented
- `503`: Service unavailable

---

[API](https://skmtc.dev/oecd/apis/sdmx-restful-api-v1-5-0.md) - [All operations](https://skmtc.dev/oecd/apis/sdmx-restful-api-v1-5-0/llms.txt) - [OpenAPI document](https://skmtc.dev/oecd/apis/sdmx-restful-api-v1-5-0/revisions/328bd4a98bba?raw)