Read Families of a Person

This example request illustrates how to read the families of a person, including relationships to parents, spouses, children, and siblings.

JSON

Request

GET /platform/tree/persons/PNM-PQRS/families
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
Content-location: /platform/tree/persons/PNM-PQRS/families
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked{
  "links" : {
    "person" : {
      "href" : "https://api.familysearch.org/platform/tree/persons/PNM-PQRS?flag=fsh"
    },
    "collection" : {
      "href" : "https://api.familysearch.org/collections/tree?flag=fsh"
    },
    "portrait" : {
      "href" : "https://api.familysearch.org/platform/tree/persons/PNM-PQRS/portrait?flag=fsh"
    }
  },
  "description" : "#SD-PNM-PQRS",
  "persons" : [ {
    "id" : "PNM-PQRS",
    "links" : {
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/PNM-PQRS?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "John Green"
      } ]
    } ]
  }, {
    "id" : "FNM-PQRS",
    "links" : {
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/FNM-PQRS?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Joseph Green"
      } ]
    } ]
  }, {
    "id" : "MNM-PQRS",
    "links" : {
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/MNM-PQRS?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Jenny Brown"
      } ]
    } ]
  }, {
    "id" : "SNM-PQRS",
    "links" : {
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/SNM-PQRS?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Sally Green"
      } ]
    } ]
  }, {
    "id" : "WNM-PQRS",
    "links" : {
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/WNM-PQRS?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Sandra Redd"
      } ]
    } ]
  }, {
    "id" : "CNM-PQRS",
    "links" : {
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/CNM-PQRS?flag=fsh"
      }
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Jeremy Green"
      } ]
    } ]
  } ],
  "relationships" : [ {
    "id" : "PSR-1234",
    "person1" : {
      "resource" : "#PNM-PQRS",
      "resourceId" : "PNM-PQRS"
    },
    "person2" : {
      "resource" : "#WNM-PQRS",
      "resourceId" : "WNM-PQRS"
    },
    "links" : {
      "relationship" : {
        "href" : "https://api.familysearch.org/platform/tree/couple-relationships/PSR-1234?flag=fsh"
      }
    }
  }, {
    "id" : "FMR-1234",
    "person1" : {
      "resource" : "#FNM-PQRS",
      "resourceId" : "FNM-PQRS"
    },
    "person2" : {
      "resource" : "#MNM-PQRS",
      "resourceId" : "MNM-PQRS"
    },
    "links" : {
      "relationship" : {
        "href" : "https://api.familysearch.org/platform/tree/couple-relationships/FMR-1234?flag=fsh"
      }
    }
  }, {
    "id" : "P1PFM-1234",
    "type" : "http://gedcomx.org/ParentChild",
    "person1" : {
      "resource" : "#FNM-PQRS",
      "resourceId" : "FNM-PQRS"
    },
    "person2" : {
      "resource" : "#PNM-PQRS",
      "resourceId" : "PNM-PQRS"
    }
  }, {
    "id" : "P2PFM-1234",
    "type" : "http://gedcomx.org/ParentChild",
    "person1" : {
      "resource" : "#MNM-PQRS",
      "resourceId" : "MNM-PQRS"
    },
    "person2" : {
      "resource" : "#PNM-PQRS",
      "resourceId" : "PNM-PQRS"
    }
  }, {
    "id" : "P1SFM-1234",
    "type" : "http://gedcomx.org/ParentChild",
    "person1" : {
      "resource" : "#FNM-PQRS",
      "resourceId" : "FNM-PQRS"
    },
    "person2" : {
      "resource" : "#SNM-PQRS",
      "resourceId" : "SNM-PQRS"
    }
  }, {
    "id" : "P2SFM-1234",
    "type" : "http://gedcomx.org/ParentChild",
    "person1" : {
      "resource" : "#MNM-PQRS",
      "resourceId" : "MNM-PQRS"
    },
    "person2" : {
      "resource" : "#SNM-PQRS",
      "resourceId" : "SNM-PQRS"
    }
  }, {
    "id" : "P1CPS-1234",
    "type" : "http://gedcomx.org/ParentChild",
    "person1" : {
      "resource" : "#PNM-PQRS",
      "resourceId" : "PNM-PQRS"
    },
    "person2" : {
      "resource" : "#CNM-PQRS",
      "resourceId" : "CNM-PQRS"
    }
  }, {
    "id" : "P2CPS-1234",
    "type" : "http://gedcomx.org/ParentChild",
    "person1" : {
      "resource" : "#WNM-PQRS",
      "resourceId" : "WNM-PQRS"
    },
    "person2" : {
      "resource" : "#CNM-PQRS",
      "resourceId" : "CNM-PQRS"
    }
  } ],
  "sourceDescriptions" : [ {
    "id" : "SD-PNM-PQRS",
    "about" : "#PNM-PQRS",
    "componentOf" : {
      "description" : "https://api.familysearch.org/platform/collections/tree"
    },
    "resourceType" : "http://gedcomx.org/Person",
    "citations" : [ {
      "lang" : "en",
      "value" : "\"Family Tree,\" database, <i>FamilySearch</i> (http://familysearch.org), entry for John Green; contributed by various users."
    } ],
    "titles" : [ {
      "value" : "John Green"
    } ]
  } ],
  "childAndParentsRelationships" : [ {
    "id" : "PFM-1234",
    "parent1" : {
      "resource" : "#FNM-PQRS",
      "resourceId" : "FNM-PQRS"
    },
    "parent2" : {
      "resource" : "#MNM-PQRS",
      "resourceId" : "MNM-PQRS"
    },
    "child" : {
      "resource" : "#PNM-PQRS",
      "resourceId" : "PNM-PQRS"
    },
    "links" : {
      "relationship" : {
        "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/PFM-1234?flag=fsh"
      }
    }
  }, {
    "id" : "SFM-1234",
    "parent1" : {
      "resource" : "#FNM-PQRS",
      "resourceId" : "FNM-PQRS"
    },
    "parent2" : {
      "resource" : "#MNM-PQRS",
      "resourceId" : "MNM-PQRS"
    },
    "child" : {
      "resource" : "#SNM-PQRS",
      "resourceId" : "SNM-PQRS"
    },
    "links" : {
      "relationship" : {
        "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/SFM-1234?flag=fsh"
      }
    }
  }, {
    "id" : "CPS-1234",
    "parent1" : {
      "resource" : "#PNM-PQRS",
      "resourceId" : "PNM-PQRS"
    },
    "parent2" : {
      "resource" : "#WNM-PQRS",
      "resourceId" : "WNM-PQRS"
    },
    "child" : {
      "resource" : "#CNM-PQRS",
      "resourceId" : "CNM-PQRS"
    },
    "links" : {
      "relationship" : {
        "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/CPS-1234?flag=fsh"
      }
    }
  } ]
}

XML

Request

GET /platform/tree/persons/PNM-PQRS/families
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
Content-location: /platform/tree/persons/PNM-PQRS/families
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" description="#SD-PNM-PQRS">
    <link rel="collection" href="https://api.familysearch.org/collections/tree?flag=fsh"/>
    <link rel="person" href="https://api.familysearch.org/platform/tree/persons/PNM-PQRS?flag=fsh"/>
    <link rel="portrait" href="https://api.familysearch.org/platform/tree/persons/PNM-PQRS/portrait?flag=fsh"/>
    <person id="PNM-PQRS">
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/PNM-PQRS?flag=fsh"/>
        <name>
            <nameForm>
                <fullText>John Green</fullText>
            </nameForm>
        </name>
    </person>
    <person id="FNM-PQRS">
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/FNM-PQRS?flag=fsh"/>
        <name>
            <nameForm>
                <fullText>Joseph Green</fullText>
            </nameForm>
        </name>
    </person>
    <person id="MNM-PQRS">
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/MNM-PQRS?flag=fsh"/>
        <name>
            <nameForm>
                <fullText>Jenny Brown</fullText>
            </nameForm>
        </name>
    </person>
    <person id="SNM-PQRS">
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/SNM-PQRS?flag=fsh"/>
        <name>
            <nameForm>
                <fullText>Sally Green</fullText>
            </nameForm>
        </name>
    </person>
    <person id="WNM-PQRS">
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/WNM-PQRS?flag=fsh"/>
        <name>
            <nameForm>
                <fullText>Sandra Redd</fullText>
            </nameForm>
        </name>
    </person>
    <person id="CNM-PQRS">
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/CNM-PQRS?flag=fsh"/>
        <name>
            <nameForm>
                <fullText>Jeremy Green</fullText>
            </nameForm>
        </name>
    </person>
    <relationship id="PSR-1234">
        <link rel="relationship" href="https://api.familysearch.org/platform/tree/couple-relationships/PSR-1234?flag=fsh"/>
        <person1 resource="#PNM-PQRS" resourceId="PNM-PQRS"/>
        <person2 resource="#WNM-PQRS" resourceId="WNM-PQRS"/>
    </relationship>
    <relationship id="FMR-1234">
        <link rel="relationship" href="https://api.familysearch.org/platform/tree/couple-relationships/FMR-1234?flag=fsh"/>
        <person1 resource="#FNM-PQRS" resourceId="FNM-PQRS"/>
        <person2 resource="#MNM-PQRS" resourceId="MNM-PQRS"/>
    </relationship>
    <relationship type="http://gedcomx.org/ParentChild" id="P1PFM-1234">
        <person1 resource="#FNM-PQRS" resourceId="FNM-PQRS"/>
        <person2 resource="#PNM-PQRS" resourceId="PNM-PQRS"/>
    </relationship>
    <relationship type="http://gedcomx.org/ParentChild" id="P2PFM-1234">
        <person1 resource="#MNM-PQRS" resourceId="MNM-PQRS"/>
        <person2 resource="#PNM-PQRS" resourceId="PNM-PQRS"/>
    </relationship>
    <relationship type="http://gedcomx.org/ParentChild" id="P1SFM-1234">
        <person1 resource="#FNM-PQRS" resourceId="FNM-PQRS"/>
        <person2 resource="#SNM-PQRS" resourceId="SNM-PQRS"/>
    </relationship>
    <relationship type="http://gedcomx.org/ParentChild" id="P2SFM-1234">
        <person1 resource="#MNM-PQRS" resourceId="MNM-PQRS"/>
        <person2 resource="#SNM-PQRS" resourceId="SNM-PQRS"/>
    </relationship>
    <relationship type="http://gedcomx.org/ParentChild" id="P1CPS-1234">
        <person1 resource="#PNM-PQRS" resourceId="PNM-PQRS"/>
        <person2 resource="#CNM-PQRS" resourceId="CNM-PQRS"/>
    </relationship>
    <relationship type="http://gedcomx.org/ParentChild" id="P2CPS-1234">
        <person1 resource="#WNM-PQRS" resourceId="WNM-PQRS"/>
        <person2 resource="#CNM-PQRS" resourceId="CNM-PQRS"/>
    </relationship>
    <sourceDescription about="#PNM-PQRS" resourceType="http://gedcomx.org/Person" id="SD-PNM-PQRS">
        <citation xml:lang="en">
            <value>"Family Tree," database, &lt;i&gt;FamilySearch&lt;/i&gt; (http://familysearch.org), entry for John Green; contributed by various users.</value>
        </citation>
        <componentOf description="https://api.familysearch.org/platform/collections/tree"/>
        <title>John Green</title>
    </sourceDescription>
    <fs:childAndParentsRelationship id="PFM-1234">
        <link rel="relationship" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/PFM-1234?flag=fsh"/>
        <fs:parent1 resource="#FNM-PQRS" resourceId="FNM-PQRS"/>
        <fs:parent2 resource="#MNM-PQRS" resourceId="MNM-PQRS"/>
        <fs:child resource="#PNM-PQRS" resourceId="PNM-PQRS"/>
    </fs:childAndParentsRelationship>
    <fs:childAndParentsRelationship id="SFM-1234">
        <link rel="relationship" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/SFM-1234?flag=fsh"/>
        <fs:parent1 resource="#FNM-PQRS" resourceId="FNM-PQRS"/>
        <fs:parent2 resource="#MNM-PQRS" resourceId="MNM-PQRS"/>
        <fs:child resource="#SNM-PQRS" resourceId="SNM-PQRS"/>
    </fs:childAndParentsRelationship>
    <fs:childAndParentsRelationship id="CPS-1234">
        <link rel="relationship" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/CPS-1234?flag=fsh"/>
        <fs:parent1 resource="#PNM-PQRS" resourceId="PNM-PQRS"/>
        <fs:parent2 resource="#WNM-PQRS" resourceId="WNM-PQRS"/>
        <fs:child resource="#CNM-PQRS" resourceId="CNM-PQRS"/>
    </fs:childAndParentsRelationship>
</fs:familysearch>