GuidesAPI ReferenceChangelogHelp
Guides

Read Parents of a Person

Suggest Edits

This example request illustrates how to read the list of relationships to the parents of a person, including any couple relationships of the parents.

JSON

Request

GET /platform/tree/persons/pid-3/parents
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/pid-3/parents
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked{
  "persons" : [ {
    "id" : "FJP-M4RK",
    "attribution" : {
      "changeMessage" : "wikipedia knows"
    },
    "living" : true,
    "gender" : {
      "type" : "http://gedcomx.org/Male"
    },
    "links" : {
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/FJP-M4RK?flag=fsh"
      }
    },
    "identifiers" : {
      "http://gedcomx.org/Persistent" : [ "https://familysearch.org/ark:/61903/4:1:FJP-M4RK" ]
    },
    "names" : [ {
      "id" : "name-id",
      "attribution" : {
        "contributor" : {
          "resource" : "urn:name-attribution",
          "resourceId" : "KNCV-RMZ"
        }
      },
      "type" : "http://gedcomx.org/BirthName",
      "preferred" : true,
      "nameForms" : [ {
        "fullText" : "Alex Aleksandrova",
        "parts" : [ {
          "type" : "http://gedcomx.org/Given",
          "value" : "Alex"
        }, {
          "type" : "http://gedcomx.org/Surname",
          "value" : "Aleksandrova"
        } ]
      }, {
        "fullText" : "Анастасия Александрова",
        "parts" : [ {
          "type" : "http://gedcomx.org/Given",
          "value" : "Анастасия"
        }, {
          "type" : "http://gedcomx.org/Surname",
          "value" : "Александрова"
        } ]
      } ]
    } ],
    "facts" : [ {
      "id" : "born",
      "attribution" : {
        "contributor" : {
          "resource" : "urn:fact-attribution",
          "resourceId" : "RMQW-LPK"
        }
      },
      "type" : "http://gedcomx.org/Birth",
      "date" : {
        "original" : "3 Apr 1836",
        "formal" : "+1836"
      },
      "place" : {
        "original" : "Moscow, Russia",
        "normalized" : [ {
          "lang" : "en",
          "value" : "Moscow, Moskva, Russia"
        } ]
      }
    }, {
      "id" : "res",
      "attribution" : {
        "contributor" : {
          "resource" : "https://api.familysearch.org/platform/users/agents/JNYR-KJP",
          "resourceId" : "JNYR-KJP"
        }
      },
      "type" : "http://gedcomx.org/Residence",
      "date" : {
        "original" : "13 Apr 1836",
        "formal" : "+1836-04-13"
      },
      "place" : {
        "original" : "Moscow, Russia",
        "normalized" : [ {
          "value" : "Moskva, Moscow, Russia"
        } ]
      }
    } ],
    "display" : {
      "name" : "Alex Aleksandrova",
      "gender" : "Male",
      "lifespan" : "3 Apr 1836 - Dead",
      "birthDate" : "3 Apr 1836",
      "birthPlace" : "Moscow, Russia"
    }
  }, {
    "id" : "JRW-NMSD",
    "attribution" : {
      "changeMessage" : "wikipedia knows"
    },
    "living" : true,
    "gender" : {
      "type" : "http://gedcomx.org/Female"
    },
    "links" : {
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/JRW-NMSD?flag=fsh"
      }
    },
    "identifiers" : {
      "http://gedcomx.org/Persistent" : [ "https://familysearch.org/ark:/61903/4:1:JRW-NMSD" ]
    },
    "names" : [ {
      "id" : "name-id",
      "attribution" : {
        "contributor" : {
          "resource" : "urn:name-attribution",
          "resourceId" : "KNCV-RMZ"
        }
      },
      "type" : "http://gedcomx.org/BirthName",
      "preferred" : true,
      "nameForms" : [ {
        "fullText" : "Anastasia Aleksandrova",
        "parts" : [ {
          "type" : "http://gedcomx.org/Given",
          "value" : "Anastasia"
        }, {
          "type" : "http://gedcomx.org/Surname",
          "value" : "Aleksandrova"
        } ]
      }, {
        "fullText" : "Анастасия Александрова",
        "parts" : [ {
          "type" : "http://gedcomx.org/Given",
          "value" : "Анастасия"
        }, {
          "type" : "http://gedcomx.org/Surname",
          "value" : "Александрова"
        } ]
      } ]
    } ],
    "facts" : [ {
      "id" : "born",
      "attribution" : {
        "contributor" : {
          "resource" : "urn:fact-attribution",
          "resourceId" : "RMQW-LPK"
        }
      },
      "type" : "http://gedcomx.org/Birth",
      "date" : {
        "original" : "3 Apr 1836",
        "formal" : "+1836"
      },
      "place" : {
        "original" : "Moscow, Russia",
        "normalized" : [ {
          "lang" : "en",
          "value" : "Moscow, Moskva, Russia"
        } ]
      }
    }, {
      "id" : "res",
      "attribution" : {
        "contributor" : {
          "resource" : "https://api.familysearch.org/platform/users/agents/JNYR-KJP",
          "resourceId" : "JNYR-KJP"
        }
      },
      "type" : "http://gedcomx.org/Residence",
      "date" : {
        "original" : "13 Apr 1836",
        "formal" : "+1836-04-13"
      },
      "place" : {
        "original" : "Moscow, Russia",
        "normalized" : [ {
          "value" : "Moskva, Moscow, Russia"
        } ]
      }
    } ],
    "display" : {
      "name" : "Anastasia Aleksandrova",
      "gender" : "Female",
      "lifespan" : "3 Apr 1836 - Dead",
      "birthDate" : "3 Apr 1836",
      "birthPlace" : "Moscow, Russia"
    }
  } ],
  "relationships" : [ {
    "id" : "CCC-0123",
    "type" : "http://gedcomx.org/Couple",
    "person1" : {
      "resource" : "#FJP-M4RK",
      "resourceId" : "FJP-M4RK"
    },
    "person2" : {
      "resource" : "#JRW-NMSD",
      "resourceId" : "JRW-NMSD"
    },
    "links" : {
      "source-references" : {
        "href" : "https://api.familysearch.org/platform/tree/couple-relationships/CCC-0123/source-references?flag=fsh"
      },
      "change-history" : {
        "href" : "https://api.familysearch.org/platform/tree/couple-relationships/CCC-0123/changes?flag=fsh"
      },
      "person2" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/JRW-NMSD?flag=fsh"
      },
      "notes" : {
        "href" : "https://api.familysearch.org/platform/tree/couple-relationships/CCC-0123/notes?flag=fsh"
      },
      "person1" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/FJP-M4RK?flag=fsh"
      },
      "source-descriptions" : {
        "href" : "https://api.familysearch.org/platform/tree/couple-relationships/CCC-0123/sources?flag=fsh"
      },
      "relationship" : {
        "href" : "https://api.familysearch.org/platform/tree/couple-relationships/CCC-0123?flag=fsh"
      }
    },
    "facts" : [ {
      "attribution" : {
        "contributor" : {
          "resource" : "https://api.familysearch.org/platform/users/agents/JNYR-KJP"
        }
      },
      "type" : "http://gedcomx.org/Marriage",
      "date" : {
        "original" : "June 1800",
        "formal" : "+1800-06"
      },
      "place" : {
        "original" : "Provo, Utah, Utah, United States"
      }
    } ]
  }, {
    "id" : "P1PPPX-PP0",
    "type" : "http://gedcomx.org/ParentChild",
    "person1" : {
      "resource" : "#FJP-M4RK",
      "resourceId" : "FJP-M4RK"
    },
    "person2" : {
      "resource" : "https://api.familysearch.org/platform/tree/persons/pid-3",
      "resourceId" : "pid-3"
    },
    "links" : {
      "parent" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/FJP-M4RK?flag=fsh"
      },
      "person2" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/pid-3?flag=fsh"
      },
      "person1" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/FJP-M4RK?flag=fsh"
      },
      "child" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/pid-3?flag=fsh"
      }
    }
  }, {
    "id" : "P2PPPX-PP0",
    "type" : "http://gedcomx.org/ParentChild",
    "person1" : {
      "resource" : "#JRW-NMSD",
      "resourceId" : "JRW-NMSD"
    },
    "person2" : {
      "resource" : "https://api.familysearch.org/platform/tree/persons/pid-3",
      "resourceId" : "pid-3"
    },
    "links" : {
      "parent" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/JRW-NMSD?flag=fsh"
      },
      "person2" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/pid-3?flag=fsh"
      },
      "person1" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/JRW-NMSD?flag=fsh"
      },
      "child" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/pid-3?flag=fsh"
      }
    }
  } ],
  "childAndParentsRelationships" : [ {
    "id" : "PPPX-PP0",
    "parent1" : {
      "resource" : "#FJP-M4RK",
      "resourceId" : "FJP-M4RK"
    },
    "parent2" : {
      "resource" : "#JRW-NMSD",
      "resourceId" : "JRW-NMSD"
    },
    "child" : {
      "resource" : "https://api.familysearch.org/platform/tree/persons/pid-3",
      "resourceId" : "pid-3"
    },
    "links" : {
      "parent1" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/FJP-M4RK?flag=fsh"
      },
      "parent2-role" : {
        "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/parent2?flag=fsh"
      },
      "source-references" : {
        "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/source-references?flag=fsh"
      },
      "change-history" : {
        "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/changes?flag=fsh"
      },
      "notes" : {
        "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/notes?flag=fsh"
      },
      "source-descriptions" : {
        "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/sources?flag=fsh"
      },
      "parent1-role" : {
        "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/parent1?flag=fsh"
      },
      "collection" : {
        "href" : "https://api.familysearch.org/collections/tree?flag=fsh"
      },
      "relationship" : {
        "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0?flag=fsh"
      },
      "parent2" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/JRW-NMSD?flag=fsh"
      },
      "child" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/pid-3?flag=fsh"
      }
    },
    "parent1Facts" : [ {
      "id" : "C.1",
      "attribution" : {
        "contributor" : {
          "resource" : "https://api.familysearch.org/platform/users/agents/JNYR-KJP"
        }
      },
      "type" : "http://gedcomx.org/AdoptiveParent"
    } ],
    "parent2Facts" : [ {
      "id" : "C.2",
      "attribution" : {
        "contributor" : {
          "resource" : "https://api.familysearch.org/platform/users/agents/JNYR-KJP"
        }
      },
      "type" : "http://gedcomx.org/BiologicalParent"
    } ]
  } ]
}

XML

Request

GET /platform/tree/persons/pid-3/parents
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/pid-3/parents
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">
    <person id="FJP-M4RK">
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/FJP-M4RK?flag=fsh"/>
        <attribution>
            <changeMessage>wikipedia knows</changeMessage>
        </attribution>
        <identifier type="http://gedcomx.org/Persistent">https://familysearch.org/ark:/61903/4:1:FJP-M4RK</identifier>
        <living>true</living>
        <gender type="http://gedcomx.org/Male"/>
        <name type="http://gedcomx.org/BirthName" id="name-id">
            <attribution>
                <contributor resource="urn:name-attribution" resourceId="KNCV-RMZ"/>
            </attribution>
            <preferred>true</preferred>
            <nameForm>
                <fullText>Alex Aleksandrova</fullText>
                <part type="http://gedcomx.org/Given" value="Alex"/>
                <part type="http://gedcomx.org/Surname" value="Aleksandrova"/>
            </nameForm>
            <nameForm>
                <fullText>Анастасия Александрова</fullText>
                <part type="http://gedcomx.org/Given" value="Анастасия"/>
                <part type="http://gedcomx.org/Surname" value="Александрова"/>
            </nameForm>
        </name>
        <fact type="http://gedcomx.org/Birth" id="born">
            <attribution>
                <contributor resource="urn:fact-attribution" resourceId="RMQW-LPK"/>
            </attribution>
            <date>
                <original>3 Apr 1836</original>
                <formal>+1836</formal>
            </date>
            <place>
                <original>Moscow, Russia</original>
                <normalized xml:lang="en">Moscow, Moskva, Russia</normalized>
            </place>
        </fact>
        <fact type="http://gedcomx.org/Residence" id="res">
            <attribution>
                <contributor resource="https://api.familysearch.org/platform/users/agents/JNYR-KJP" resourceId="JNYR-KJP"/>
            </attribution>
            <date>
                <original>13 Apr 1836</original>
                <formal>+1836-04-13</formal>
            </date>
            <place>
                <original>Moscow, Russia</original>
                <normalized>Moskva, Moscow, Russia</normalized>
            </place>
        </fact>
        <display>
            <birthDate>3 Apr 1836</birthDate>
            <birthPlace>Moscow, Russia</birthPlace>
            <gender>Male</gender>
            <lifespan>3 Apr 1836 - Dead</lifespan>
            <name>Alex Aleksandrova</name>
        </display>
    </person>
    <person id="JRW-NMSD">
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/JRW-NMSD?flag=fsh"/>
        <attribution>
            <changeMessage>wikipedia knows</changeMessage>
        </attribution>
        <identifier type="http://gedcomx.org/Persistent">https://familysearch.org/ark:/61903/4:1:JRW-NMSD</identifier>
        <living>true</living>
        <gender type="http://gedcomx.org/Female"/>
        <name type="http://gedcomx.org/BirthName" id="name-id">
            <attribution>
                <contributor resource="urn:name-attribution" resourceId="KNCV-RMZ"/>
            </attribution>
            <preferred>true</preferred>
            <nameForm>
                <fullText>Anastasia Aleksandrova</fullText>
                <part type="http://gedcomx.org/Given" value="Anastasia"/>
                <part type="http://gedcomx.org/Surname" value="Aleksandrova"/>
            </nameForm>
            <nameForm>
                <fullText>Анастасия Александрова</fullText>
                <part type="http://gedcomx.org/Given" value="Анастасия"/>
                <part type="http://gedcomx.org/Surname" value="Александрова"/>
            </nameForm>
        </name>
        <fact type="http://gedcomx.org/Birth" id="born">
            <attribution>
                <contributor resource="urn:fact-attribution" resourceId="RMQW-LPK"/>
            </attribution>
            <date>
                <original>3 Apr 1836</original>
                <formal>+1836</formal>
            </date>
            <place>
                <original>Moscow, Russia</original>
                <normalized xml:lang="en">Moscow, Moskva, Russia</normalized>
            </place>
        </fact>
        <fact type="http://gedcomx.org/Residence" id="res">
            <attribution>
                <contributor resource="https://api.familysearch.org/platform/users/agents/JNYR-KJP" resourceId="JNYR-KJP"/>
            </attribution>
            <date>
                <original>13 Apr 1836</original>
                <formal>+1836-04-13</formal>
            </date>
            <place>
                <original>Moscow, Russia</original>
                <normalized>Moskva, Moscow, Russia</normalized>
            </place>
        </fact>
        <display>
            <birthDate>3 Apr 1836</birthDate>
            <birthPlace>Moscow, Russia</birthPlace>
            <gender>Female</gender>
            <lifespan>3 Apr 1836 - Dead</lifespan>
            <name>Anastasia Aleksandrova</name>
        </display>
    </person>
    <relationship type="http://gedcomx.org/Couple" id="CCC-0123">
        <link rel="change-history" href="https://api.familysearch.org/platform/tree/couple-relationships/CCC-0123/changes?flag=fsh"/>
        <link rel="notes" href="https://api.familysearch.org/platform/tree/couple-relationships/CCC-0123/notes?flag=fsh"/>
        <link rel="person1" href="https://api.familysearch.org/platform/tree/persons/FJP-M4RK?flag=fsh"/>
        <link rel="person2" href="https://api.familysearch.org/platform/tree/persons/JRW-NMSD?flag=fsh"/>
        <link rel="relationship" href="https://api.familysearch.org/platform/tree/couple-relationships/CCC-0123?flag=fsh"/>
        <link rel="source-descriptions" href="https://api.familysearch.org/platform/tree/couple-relationships/CCC-0123/sources?flag=fsh"/>
        <link rel="source-references" href="https://api.familysearch.org/platform/tree/couple-relationships/CCC-0123/source-references?flag=fsh"/>
        <person1 resource="#FJP-M4RK" resourceId="FJP-M4RK"/>
        <person2 resource="#JRW-NMSD" resourceId="JRW-NMSD"/>
        <fact type="http://gedcomx.org/Marriage">
            <attribution>
                <contributor resource="https://api.familysearch.org/platform/users/agents/JNYR-KJP"/>
            </attribution>
            <date>
                <original>June 1800</original>
                <formal>+1800-06</formal>
            </date>
            <place>
                <original>Provo, Utah, Utah, United States</original>
            </place>
        </fact>
    </relationship>
    <relationship type="http://gedcomx.org/ParentChild" id="P1PPPX-PP0">
        <link rel="child" href="https://api.familysearch.org/platform/tree/persons/pid-3?flag=fsh"/>
        <link rel="parent" href="https://api.familysearch.org/platform/tree/persons/FJP-M4RK?flag=fsh"/>
        <link rel="person1" href="https://api.familysearch.org/platform/tree/persons/FJP-M4RK?flag=fsh"/>
        <link rel="person2" href="https://api.familysearch.org/platform/tree/persons/pid-3?flag=fsh"/>
        <person1 resource="#FJP-M4RK" resourceId="FJP-M4RK"/>
        <person2 resource="https://api.familysearch.org/platform/tree/persons/pid-3" resourceId="pid-3"/>
    </relationship>
    <relationship type="http://gedcomx.org/ParentChild" id="P2PPPX-PP0">
        <link rel="child" href="https://api.familysearch.org/platform/tree/persons/pid-3?flag=fsh"/>
        <link rel="parent" href="https://api.familysearch.org/platform/tree/persons/JRW-NMSD?flag=fsh"/>
        <link rel="person1" href="https://api.familysearch.org/platform/tree/persons/JRW-NMSD?flag=fsh"/>
        <link rel="person2" href="https://api.familysearch.org/platform/tree/persons/pid-3?flag=fsh"/>
        <person1 resource="#JRW-NMSD" resourceId="JRW-NMSD"/>
        <person2 resource="https://api.familysearch.org/platform/tree/persons/pid-3" resourceId="pid-3"/>
    </relationship>
    <fs:childAndParentsRelationship id="PPPX-PP0">
        <link rel="change-history" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/changes?flag=fsh"/>
        <link rel="child" href="https://api.familysearch.org/platform/tree/persons/pid-3?flag=fsh"/>
        <link rel="collection" href="https://api.familysearch.org/collections/tree?flag=fsh"/>
        <link rel="notes" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/notes?flag=fsh"/>
        <link rel="parent1-role" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/parent1?flag=fsh"/>
        <link rel="parent1" href="https://api.familysearch.org/platform/tree/persons/FJP-M4RK?flag=fsh"/>
        <link rel="parent2-role" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/parent2?flag=fsh"/>
        <link rel="parent2" href="https://api.familysearch.org/platform/tree/persons/JRW-NMSD?flag=fsh"/>
        <link rel="relationship" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0?flag=fsh"/>
        <link rel="source-descriptions" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/sources?flag=fsh"/>
        <link rel="source-references" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/PPPX-PP0/source-references?flag=fsh"/>
        <fs:parent1 resource="#FJP-M4RK" resourceId="FJP-M4RK"/>
        <fs:parent2 resource="#JRW-NMSD" resourceId="JRW-NMSD"/>
        <fs:child resource="https://api.familysearch.org/platform/tree/persons/pid-3" resourceId="pid-3"/>
        <fs:parent1Fact type="http://gedcomx.org/AdoptiveParent" id="C.1">
            <attribution>
                <contributor resource="https://api.familysearch.org/platform/users/agents/JNYR-KJP"/>
            </attribution>
        </fs:parent1Fact>
        <fs:parent2Fact type="http://gedcomx.org/BiologicalParent" id="C.2">
            <attribution>
                <contributor resource="https://api.familysearch.org/platform/users/agents/JNYR-KJP"/>
            </attribution>
        </fs:parent2Fact>
    </fs:childAndParentsRelationship>
</fs:familysearch>

Updated 5 days ago