---
title: "Get the descendant list for an Entity.  The descendants are the nodes \"downstream\" from the current node.  This list traverses all the levels in the graph. Returns all descendants as an array of Entities."
method: GET
path: "/descendants/{id}"
---

# Get the descendant list for an Entity.  The descendants are the nodes "downstream" from the current node.  This list traverses all the levels in the graph. Returns all descendants as an array of Entities.

`GET /descendants/{id}`

## Path parameters

- `id` string, required

## Response `200`

An array of descendants is returned

- object[]

## Other responses

- `303` — If the total response payload exceeds 10 MB, the response is returned via an S3 bucket. A 303 HTTP response code will be returned with the redirect URL where the query can be retrieved.
- `400` — Invalid or misformatted entity identifier
- `401` — The user's token has expired or the user did not supply a valid token
- `403` — The user is not authorized to access the entity.
- `404` — The target entity 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)