---
title: "Read Ancestry"
method: GET
path: "/tree/ancestry"
tags: ["Pedigrees"]
---

# Read Ancestry

`GET /tree/ancestry`

Read a person and the person's ancestors for the specified number of generations. The result of the query is a list of persons. Each person comes with an ascendancy number in the display properties for the person. The ascendancy number is interpreted as an <a href="http://en.wikipedia.org/wiki/Ahnentafel">ahnentafel number</a> that determines the position of each person in the pedigree.

## Query parameters

- `person` string, required
- `spouse` string
- `generations` integer
- `personDetails` boolean
- `marriageDetails` boolean
- `descendants` boolean

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