---
title: "Get a list of dataset series that have unpublished versions"
method: GET
path: "/dataset-editions"
tags: ["Private"]
---

# Get a list of dataset series that have unpublished versions

`GET /dataset-editions`

## Request

- Base URL: `https://api.beta.ons.gov.uk/v1`
- URL: `https://api.beta.ons.gov.uk/v1/dataset-editions`
- Auth: API key in header `Authorization`

Get a list of dataset series that have unpublished versions. This is used to easily determine versions/editions of series that are awaiting publication.

## Query parameters

- `state` string
- `published` boolean
- `limit` integer
- `offset` integer

## Response `200`

A json list containing all dataset editions that have unpublished versions

- DatasetEdition[]
  - `dataset_id` string, required: The unique identifier for a dataset. The dataset ID cannot be changed once the series is first published.
  - `title` string, required: The title of the dataset
  - `description` string, required: The description of the dataset
  - `edition` string, required: The unique identifier for an edition of a dataset. The edition ID cannot be changed once first published. If a subsequent version of the edition attempts to change the edition ID, they will be treated as the first version of a new edition instead.
  - `edition_title` string, required: The human readable title of the edition
  - `latest_version` LatestVersionLink, required: An object containing the latest version id and link
    - `href` string: A link to the latest version and edition of the dataset
    - `id` string: The unique id for the latest version of a dataset
  - `release_date` string, date-time, required: The release date of the this version of the dataset edition
  - `state` 'created' | 'completed' | 'failed' | 'edition-confirmed' | 'associated' | 'published', required: The state of the resource, can only be one of the following: * created * completed (instances only) * failed (instances only) * edition-confirmed (instances and versions only) * associated (not editions) * published

## Other responses

- `400`: Invalid query parameter
- `401`: Unauthorised to access endpoint
- `404`: No versions were found
- `500`: Failed to process the request due to an internal error

---

[API](https://skmtc.dev/office-of-national-statistics/apis/dataset-api.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/dataset-api/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/dataset-api/revisions/a2947a13d675?raw)