Read Ancestry

get

https://apibeta.familysearch.org/platform/tree/ancestry

Read a person and the person's ancestors for the specified number of generations

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 query was successful.

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

Response

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