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

# Get a list of editions

`GET /code-lists/{id}/editions`

Get a list of editions associated with a code list

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Json object containing an array of editions

- Editions
  - `items` Edition[]
    - `edition` string — The edition
    - `label` string — A label used by the edition
    - `links` object
      - `self` SelfHref
        - `id` string — The id of the resource
        - `href` string — The URL to the resource
      - `codes` Href
        - `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 list editions 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)