---
title: "Retrive the calculated revision number of a Dataset. The calculated revision is number is based on the [:REVISION_OF] relationships to the oldest dataset in a revision chain. Where the oldest dataset = 1 and each newer version is incremented by one (1, 2, 3 ...). 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."
method: GET
path: "/datasets/{id}/revision"
---

# Retrive the calculated revision number of a Dataset. The calculated revision is number is based on the [:REVISION_OF] relationships to the oldest dataset in a revision chain. Where the oldest dataset = 1 and each newer version is incremented by one (1, 2, 3 ...). 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.

`GET /datasets/{id}/revision`

## Path parameters

- `id` string, required

## Response `200`

The revision number (integer) on successful operation

- integer

## 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

---

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