---
title: "From a given ID of a versioned dataset, retrieve a list of every dataset in the chain ordered from most recent to oldest. The revision number, as well as the dataset uuid will be included. An optional parameter ?include_dataset=true will include the full dataset for each revision as well. Public/Consortium access rules apply, if is for a non-public dataset and no token or a token without membership in HuBMAP-Read group is sent with the request then a 403 response should be returned. If the given id is published, but later revisions are not and the user is not in HuBMAP-Read group, only published revisions will be returned. The field next_revision_uuid will not be returned if the next revision is unpublished"
method: GET
path: "/datasets/{id}/revisions"
---

# From a given ID of a versioned dataset, retrieve a list of every dataset in the chain ordered from most recent to oldest. The revision number, as well as the dataset uuid will be included. An optional parameter ?include_dataset=true will include the full dataset for each revision as well. Public/Consortium access rules apply, if is for a non-public dataset and no token or a token without membership in HuBMAP-Read group is sent with the request then a 403 response should be returned. If the given id is published, but later revisions are not and the user is not in HuBMAP-Read group, only published revisions will be returned. The field next_revision_uuid will not be returned if the next revision is unpublished

`GET /datasets/{id}/revisions`

## Path parameters

- `id` string, required

## Query parameters

- `include_dataset` 'true' | 'false'

## Response `200`

The list of revised datasets that the referenced dataset is a member of including the index number of the revision, where 1 is the oldest version of any revision chain

- object

## Other responses

- `400` — Invalid or misformatted entity identifier, or the given entity is not a Dataset
- `401` — The user's token has expired or the user did not supply a valid token
- `403` — The user is not authorized to query the revision number of the given dataset.
- `404` — The target dataset could not be found
- `500` — Internal error

## Changes

- **2025-03-12** `e6e7a8247356` — 3 warning
  - removed the optional property `dataset` from the response with the `200` status
  - removed the optional property `revision_number` from the response with the `200` status
  - removed the optional property `uuid` from the response with the `200` status

[Change history](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/changes/datasets/:id/revisions/get.md)

---

[API](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api.md) · [All operations](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hubmapconsortium/hubmap-entity-api/revisions/a192f35c6b16/schema)