---
title: "Get a list of contents within a bundle"
method: GET
path: "/bundles/{id}/contents"
tags: ["Private"]
---

# Get a list of contents within a bundle

`GET /bundles/{id}/contents`

Get a list of contents within a bundle

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

The bundle was found and the list of contents is returned

- Contents — A list of contents related to a bundle
  - `count` integer — The number of items returned.
  - `limit` integer — The number of items requested.
  - `offset` integer — The offset of the first item to retrieve, starting at 0. Use this parameter as a pagination mechanism along with the limit parameter
  - `total_count` integer — The total number of items available.
  - `items` ContentItem[]
    - `bundle_id` string — The ID of the bundle the content item is associated with.
    - `content_type` 'DATASET', required — The type of content the item is.
    - `metadata` object, required — The metadata for the content item.
      - `dataset_id` string — The dataset ID of the item in the bundle
      - `edition_id` string — The edition ID of the dataset item in the bundle
      - `title` string — The title of the dataset item. Pre-release, this field will be hydrated from the dataset API when requested. Post-release, the bundle API will store a snapshot of the dataset metadata to be returned on subsequent requests.
      - `version_id` integer — The version ID of the dataset item in the bundle
    - `id` string — An auto generated ID field to identify the item
    - `state` 'APPROVED' | 'PUBLISHED' — The approval status of the item. Pre-release, this field will be hydrated from the dataset API when requested. Post-release, the bundle API will store a snapshot of the dataset metadata to be returned on subsequent requests.
    - `links` object — Navigational links for onward actions related to the content item.
      - `edit` string, url — The URL to the admin page to make changes to the content item.
      - `preview` string, url — The URL to the preview page for the content item.

## Other responses

- `400` — Unable to process request due to a malformed or invalid request body or query parameter.
- `401` — Authentication information is missing or invalid.
- `403` — Access denied.
- `404` — The requested resource does not exist.
- `500` — Failed to process the request due to an internal error.

---

[API](https://skmtc.net/office-of-national-statistics/apis/bundle-administration.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/bundle-administration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/bundle-administration/revisions/4ac833f533b1/schema)