---
title: "Read Descendancy"
method: GET
path: "/tree/descendancy"
tags: ["Pedigrees"]
---

# Read Descendancy

`GET /tree/descendancy`

Read the descendancy of a person for a specific number of generations. The result of the query provides a list of persons. Each person will supply a descendancy number in the display properties for the person. The descendancy number is interpreted as a <a href="http://en.wikipedia.org/wiki/Genealogical_numbering_system#d.27Aboville_System">d'Aboville number</a> which can be used to determine the position of each person in the descendancy.

 The descendancy query supports the inclusion of the spouses of each person in the descendancy graph. Spouses returned in the query will also have a descendancy number, but the descendancy number will have a -S<#> appended to indicate the role of spouse. The '#' indicates the spouse number.

 <table>
  <tbody><tr>
  <th>descendancy number</th>
  <th>description</th>
  </tr>
  <tr>
  <td>1</td>
  <td>The root person.</td>
  </tr>
  <tr>
  <td>1-S1</td>
  <td>The (primary) spouse of the root person.</td>
  </tr>
  <tr>
  <td>1-S2</td>
  <td>The second spouse of the root person.</td>
  </tr>
  <tr>
  <td>1.3</td>
  <td>The third child (via the primary spouse) of the root person.</td>
  </tr>
  <tr>
  <td>1-S2.2</td>
  <td>The second child (via the second spouse) of the root person.</td>
  </tr>
  <tr>
  <td>1.2-S3.4</td>
  <td>The fourth child (via the 3rd spouse) of the second child (via the primary spouse) of the root person.</td>
  </tr>
  <tr>
  <td>1.2.5-S1</td>
  <td>The primary spouse of the fifth child (via the primary spouse) of the second child (via the primary spouse) of the root person.</td>
  </tr>
  </tbody></table>

## Query parameters

- `person` string, required
- `generations` integer, required
- `personDetails` string
- `marriageDetails` string

## Headers

- `Accept` 'application/x-fs-v1+json' | 'application/x-gedcomx-v1+json' | 'application/json' | 'application/x-fs-v1+xml' | 'application/x-gedcomx-v1+xml' | 'application/xml', required

## Response `200`

The read was successful. See <a href="https://developers.familysearch.org/main/docs/json-schema#person" target="_blank">Person Schema (JSON)</a>

## Other responses

- `301` — If the requested person has been merged to another person.
- `410` — If the requested person has been deleted.
- `429` — The request was throttled.

---

[API](https://skmtc.net/familysearch/apis/authentication-endpoints.md) · [All operations](https://skmtc.net/familysearch/apis/authentication-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/familysearch/authentication-endpoints/revisions/2b5020574a62/schema)