Read Ancestry

get

https://apibeta.familysearch.org/platform/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 ahnentafel number that determines the position of each person in the pedigree.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

person

string

required

The ID of the person whose ancestry is being queried.

spouse

string

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.

generations

int64

1 to 8

The number of generations being requested. Default is 3.

personDetails

boolean

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

marriageDetails

boolean

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

descendants

boolean

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

Headers

string

enum

required

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

Allowed:

Responses

200

The read was successful. See Person Schema (JSON)

301

If the requested person has been merged to another person.

410

If the requested person has been deleted.

429

The request was throttled.

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here!