GuidesAPI ReferenceChangelogHelp
Guides

Read Person Descendancy

Suggest Edits

This example request illustrates how to make a query for the descendancy graph of a given person. Note that only a set of persons is returned. Each person element provides display properties that describe how to display the person. The display properties include, among other things, a descendancy Numberwhich indicates the person's position in the descendancy graph using a d'Aboville number.

JSON

Request

GET /platform/tree/descendancy?person=P1mal-1
Accept: application/x-fs-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/x-fs-v1+json
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked{
  "links" : {
    "collection" : {
      "href" : "https://api.familysearch.org/collections/tree?flag=fsh"
    }
  },
  "persons" : [ {
    "id" : "P1mal-1",
    "gender" : {
      "type" : "http://gedcomx.org/Male"
    },
    "links" : {
      "ancestry" : {
        "href" : "https://api.familysearch.org/platform/tree/ancestry?flag=fsh&person=P1mal-1"
      },
      "descendancy" : {
        "href" : "https://api.familysearch.org/platform/tree/descendancy?flag=fsh&person=P1mal-1"
      },
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/P1mal-1?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Daniel Earl Bishop"
      } ]
    } ],
    "display" : {
      "name" : "Daniel Earl Bishop",
      "gender" : "Male",
      "lifespan" : "1885-1981",
      "descendancyNumber" : "1"
    }
  }, {
    "id" : "P2fem-1-S1",
    "gender" : {
      "type" : "http://gedcomx.org/Female"
    },
    "links" : {
      "ancestry" : {
        "href" : "https://api.familysearch.org/platform/tree/ancestry?flag=fsh&person=P2fem-1-S1"
      },
      "descendancy" : {
        "href" : "https://api.familysearch.org/platform/tree/descendancy?flag=fsh&person=P2fem-1-S1"
      },
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/P2fem-1-S1?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Maude Langston"
      } ]
    } ],
    "display" : {
      "name" : "Maude Langston",
      "gender" : "Female",
      "lifespan" : "1885-1949",
      "descendancyNumber" : "1-S1"
    }
  }, {
    "id" : "P3fem-1.1",
    "gender" : {
      "type" : "http://gedcomx.org/Female"
    },
    "links" : {
      "ancestry" : {
        "href" : "https://api.familysearch.org/platform/tree/ancestry?flag=fsh&person=P3fem-1.1"
      },
      "descendancy" : {
        "href" : "https://api.familysearch.org/platform/tree/descendancy?flag=fsh&person=P3fem-1.1"
      },
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/P3fem-1.1?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Elnor Bishop"
      } ]
    } ],
    "display" : {
      "name" : "Elnor Bishop",
      "gender" : "Female",
      "lifespan" : "1909-2000",
      "descendancyNumber" : "1.1"
    }
  }, {
    "id" : "P4mal-1.1-S1",
    "gender" : {
      "type" : "http://gedcomx.org/Male"
    },
    "links" : {
      "ancestry" : {
        "href" : "https://api.familysearch.org/platform/tree/ancestry?flag=fsh&person=P4mal-1.1-S1"
      },
      "descendancy" : {
        "href" : "https://api.familysearch.org/platform/tree/descendancy?flag=fsh&person=P4mal-1.1-S1"
      },
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/P4mal-1.1-S1?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Roscoe Phillips"
      } ]
    } ],
    "display" : {
      "name" : "Roscoe Phillips",
      "gender" : "Male",
      "lifespan" : "1909-2000",
      "descendancyNumber" : "1.1-S1"
    }
  }, {
    "id" : "P5fem-1.2",
    "gender" : {
      "type" : "http://gedcomx.org/Female"
    },
    "links" : {
      "ancestry" : {
        "href" : "https://api.familysearch.org/platform/tree/ancestry?flag=fsh&person=P5fem-1.2"
      },
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/P5fem-1.2?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Nelda Bishop"
      } ]
    } ],
    "display" : {
      "name" : "Nelda Bishop",
      "gender" : "Female",
      "lifespan" : "1907-1908",
      "descendancyNumber" : "1.2"
    }
  }, {
    "id" : "P6mal-1.3",
    "gender" : {
      "type" : "http://gedcomx.org/Male"
    },
    "links" : {
      "ancestry" : {
        "href" : "https://api.familysearch.org/platform/tree/ancestry?flag=fsh&person=P6mal-1.3"
      },
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/P6mal-1.3?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Fern Earl Bishop"
      } ]
    } ],
    "display" : {
      "name" : "Fern Earl Bishop",
      "gender" : "Male",
      "lifespan" : "1911-1911",
      "descendancyNumber" : "1.3"
    }
  }, {
    "id" : "P7mal-1.4",
    "gender" : {
      "type" : "http://gedcomx.org/Male"
    },
    "links" : {
      "ancestry" : {
        "href" : "https://api.familysearch.org/platform/tree/ancestry?flag=fsh&person=P7mal-1.4"
      },
      "descendancy" : {
        "href" : "https://api.familysearch.org/platform/tree/descendancy?flag=fsh&person=P7mal-1.4"
      },
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/P7mal-1.4?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Lavon Bishop"
      } ]
    } ],
    "display" : {
      "name" : "Lavon Bishop",
      "gender" : "Male",
      "lifespan" : "1912-1988",
      "descendancyNumber" : "1.4"
    }
  }, {
    "id" : "P8fem-1.4-S1",
    "gender" : {
      "type" : "http://gedcomx.org/Female"
    },
    "links" : {
      "ancestry" : {
        "href" : "https://api.familysearch.org/platform/tree/ancestry?flag=fsh&person=P8fem-1.4-S1"
      },
      "descendancy" : {
        "href" : "https://api.familysearch.org/platform/tree/descendancy?flag=fsh&person=P8fem-1.4-S1"
      },
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/P8fem-1.4-S1?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Martha Spencer"
      } ]
    } ],
    "display" : {
      "name" : "Martha Spencer",
      "gender" : "Female",
      "lifespan" : "1912-2003",
      "descendancyNumber" : "1.4-S1"
    }
  } ]
}

XML

Request

GET /platform/tree/descendancy?person=P1mal-1
Accept: application/x-fs-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/x-fs-v1+xml
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<fs:familysearch xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <link rel="collection" href="https://api.familysearch.org/collections/tree?flag=fsh"/>
    <person id="P1mal-1">
        <link rel="ancestry" href="https://api.familysearch.org/platform/tree/ancestry?flag=fsh&amp;person=P1mal-1"/>
        <link rel="descendancy" href="https://api.familysearch.org/platform/tree/descendancy?flag=fsh&amp;person=P1mal-1"/>
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/P1mal-1?flag=fsh"/>
        <gender type="http://gedcomx.org/Male"/>
        <name>
            <nameForm>
                <fullText>Daniel Earl Bishop</fullText>
            </nameForm>
        </name>
        <display>
            <descendancyNumber>1</descendancyNumber>
            <gender>Male</gender>
            <lifespan>1885-1981</lifespan>
            <name>Daniel Earl Bishop</name>
        </display>
    </person>
    <person id="P2fem-1-S1">
        <link rel="ancestry" href="https://api.familysearch.org/platform/tree/ancestry?flag=fsh&amp;person=P2fem-1-S1"/>
        <link rel="descendancy" href="https://api.familysearch.org/platform/tree/descendancy?flag=fsh&amp;person=P2fem-1-S1"/>
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/P2fem-1-S1?flag=fsh"/>
        <gender type="http://gedcomx.org/Female"/>
        <name>
            <nameForm>
                <fullText>Maude Langston</fullText>
            </nameForm>
        </name>
        <display>
            <descendancyNumber>1-S1</descendancyNumber>
            <gender>Female</gender>
            <lifespan>1885-1949</lifespan>
            <name>Maude Langston</name>
        </display>
    </person>
    <person id="P3fem-1.1">
        <link rel="ancestry" href="https://api.familysearch.org/platform/tree/ancestry?flag=fsh&amp;person=P3fem-1.1"/>
        <link rel="descendancy" href="https://api.familysearch.org/platform/tree/descendancy?flag=fsh&amp;person=P3fem-1.1"/>
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/P3fem-1.1?flag=fsh"/>
        <gender type="http://gedcomx.org/Female"/>
        <name>
            <nameForm>
                <fullText>Elnor Bishop</fullText>
            </nameForm>
        </name>
        <display>
            <descendancyNumber>1.1</descendancyNumber>
            <gender>Female</gender>
            <lifespan>1909-2000</lifespan>
            <name>Elnor Bishop</name>
        </display>
    </person>
    <person id="P4mal-1.1-S1">
        <link rel="ancestry" href="https://api.familysearch.org/platform/tree/ancestry?flag=fsh&amp;person=P4mal-1.1-S1"/>
        <link rel="descendancy" href="https://api.familysearch.org/platform/tree/descendancy?flag=fsh&amp;person=P4mal-1.1-S1"/>
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/P4mal-1.1-S1?flag=fsh"/>
        <gender type="http://gedcomx.org/Male"/>
        <name>
            <nameForm>
                <fullText>Roscoe Phillips</fullText>
            </nameForm>
        </name>
        <display>
            <descendancyNumber>1.1-S1</descendancyNumber>
            <gender>Male</gender>
            <lifespan>1909-2000</lifespan>
            <name>Roscoe Phillips</name>
        </display>
    </person>
    <person id="P5fem-1.2">
        <link rel="ancestry" href="https://api.familysearch.org/platform/tree/ancestry?flag=fsh&amp;person=P5fem-1.2"/>
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/P5fem-1.2?flag=fsh"/>
        <gender type="http://gedcomx.org/Female"/>
        <name>
            <nameForm>
                <fullText>Nelda Bishop</fullText>
            </nameForm>
        </name>
        <display>
            <descendancyNumber>1.2</descendancyNumber>
            <gender>Female</gender>
            <lifespan>1907-1908</lifespan>
            <name>Nelda Bishop</name>
        </display>
    </person>
    <person id="P6mal-1.3">
        <link rel="ancestry" href="https://api.familysearch.org/platform/tree/ancestry?flag=fsh&amp;person=P6mal-1.3"/>
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/P6mal-1.3?flag=fsh"/>
        <gender type="http://gedcomx.org/Male"/>
        <name>
            <nameForm>
                <fullText>Fern Earl Bishop</fullText>
            </nameForm>
        </name>
        <display>
            <descendancyNumber>1.3</descendancyNumber>
            <gender>Male</gender>
            <lifespan>1911-1911</lifespan>
            <name>Fern Earl Bishop</name>
        </display>
    </person>
    <person id="P7mal-1.4">
        <link rel="ancestry" href="https://api.familysearch.org/platform/tree/ancestry?flag=fsh&amp;person=P7mal-1.4"/>
        <link rel="descendancy" href="https://api.familysearch.org/platform/tree/descendancy?flag=fsh&amp;person=P7mal-1.4"/>
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/P7mal-1.4?flag=fsh"/>
        <gender type="http://gedcomx.org/Male"/>
        <name>
            <nameForm>
                <fullText>Lavon Bishop</fullText>
            </nameForm>
        </name>
        <display>
            <descendancyNumber>1.4</descendancyNumber>
            <gender>Male</gender>
            <lifespan>1912-1988</lifespan>
            <name>Lavon Bishop</name>
        </display>
    </person>
    <person id="P8fem-1.4-S1">
        <link rel="ancestry" href="https://api.familysearch.org/platform/tree/ancestry?flag=fsh&amp;person=P8fem-1.4-S1"/>
        <link rel="descendancy" href="https://api.familysearch.org/platform/tree/descendancy?flag=fsh&amp;person=P8fem-1.4-S1"/>
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/P8fem-1.4-S1?flag=fsh"/>
        <gender type="http://gedcomx.org/Female"/>
        <name>
            <nameForm>
                <fullText>Martha Spencer</fullText>
            </nameForm>
        </name>
        <display>
            <descendancyNumber>1.4-S1</descendancyNumber>
            <gender>Female</gender>
            <lifespan>1912-2003</lifespan>
            <name>Martha Spencer</name>
        </display>
    </person>
</fs:familysearch>

Updated 5 days ago