---
title: "Get a list of code lists"
method: GET
path: "/code-lists"
tags: ["Code List"]
---

# Get a list of code lists

`GET /code-lists`

Get a set of code lists containing information about dimensions which are used for all datasets at the ONS

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

A Json message containing a set of code lists

- CodeLists
  - `items` CodeList[]
    - `links` object
      - `self` SelfHref
        - `id` string — The id of the resource
        - `href` string — The URL to the resource
      - `editions` Href
        - `href` string — The URL to the resource
  - `count` string — The number of results returned in this response
  - `total_count` string — The total number of results available
  - `limit` string — The limit applied to the number of results returned
  - `offset` string — The offset applied to the number of results returned

## Other responses

- `404` — Code lists not found
- `500` — Failed to process the request due to an internal error

---

[API](https://skmtc.dev/office-of-national-statistics/apis/code-list-api.md) · [All operations](https://skmtc.dev/office-of-national-statistics/apis/code-list-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/office-of-national-statistics/code-list-api/revisions/708c5ef92f03/schema)