---
title: "Retrieve uuids for associated dataset of given data_type which shares a sample ancestor of given dataset id"
method: GET
path: "/datasets/{id}/paired-dataset"
---

# Retrieve uuids for associated dataset of given data_type which shares a sample ancestor of given dataset id

`GET /datasets/{id}/paired-dataset`

## Path parameters

- `id` string, required

## Query parameters

- `data_type` string, required
- `search_depth` integer

## Response `200`

returns a list (json array) of the uuids (if any) of the matching paired datasets.

- string[]

## Other responses

- `401` — The user's token has expired or the user did not supply a valid token
- `403` — The given dataset is unpublished and the user does not have the authorization to view it.
- `404` — Not found. No matching datasets were found, or the none were found that the user is authorized to see.
- `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)