Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-2420454370.2 KB
Pedigrees

Read 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.

get/tree/ancestry

Query parameters

personstring required

The ID of the person whose ancestry is being queried.

spousestring

If provided, the ancestry of the spouse will be included. An empty value indicates the system will choose a spouse. A value of "UNKNOWN" indicates the system will select the "unknown spouse" for purposes of drawing the pedigree.

generationsinteger

The number of generations being requested. Default is 3.

personDetailsboolean

When the query parameter is supplied then additional person details will be returned for each person in the ancestry.

marriageDetailsboolean

When the query parameter is supplied then marriage details will be returned for each person in the ancestry.

descendantsboolean

When the query parameter is supplied, additional details will be returned for each descendant in the ancestry.

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

Specifies the media type(s) that the client is willing to accept in the response.

Response

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