Read Spouses of a Person
This example request illustrates how to read the spouses of a person. Note that for the FamilySearch Family Tree, the spouses list doesn't necessarily contain a couple relationship for every spouse. Persons who share a child-and-parents relationship as a parent will also be included in the list of spouses.
JSON
Request
GET /platform/tree/persons/FJP-M4RK/spouses
Accept: application/x-gedcomx-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
Response
HTTP/1.1 200 OK
Content-type: application/x-gedcomx-v1+json
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/tree/persons/FJP-M4RK/spouses
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked{
"persons" : [ {
"id" : "LKM-MJNZ",
"attribution" : {
"changeMessage" : "wikipedia knows"
},
"living" : true,
"gender" : {
"type" : "http://gedcomx.org/Male"
},
"links" : {
"person" : {
"href" : "https://api.familysearch.org/platform/tree/persons/LKM-MJNZ?flag=fsh"
}
},
"identifiers" : {
"http://gedcomx.org/Persistent" : [ "https://familysearch.org/ark:/61903/4:1:LKM-MJNZ" ]
},
"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"
}
} ],
"relationships" : [ {
"id" : "crid",
"type" : "http://gedcomx.org/Couple",
"person1" : {
"resource" : "https://api.familysearch.org/platform/tree/persons/FJP-M4RK",
"resourceId" : "FJP-M4RK"
},
"person2" : {
"resource" : "https://api.familysearch.org/platform/tree/persons/JRW-NMSD",
"resourceId" : "JRW-NMSD"
},
"links" : {
"source-references" : {
"href" : "https://api.familysearch.org/platform/tree/couple-relationships/crid/source-references?flag=fsh"
},
"change-history" : {
"href" : "https://api.familysearch.org/platform/tree/couple-relationships/crid/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/crid/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/crid/sources?flag=fsh"
},
"collection" : {
"href" : "https://api.familysearch.org/collections/tree?flag=fsh"
},
"relationship" : {
"href" : "https://api.familysearch.org/platform/tree/couple-relationships/crid?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"
}
} ]
} ],
"childAndParentsRelationships" : [ {
"id" : "PPPX-PP0",
"parent1" : {
"resource" : "#LKM-MJNZ",
"resourceId" : "LKM-MJNZ"
},
"parent2" : {
"resource" : "https://api.familysearch.org/platform/tree/persons/FJP-M4RK",
"resourceId" : "FJP-M4RK"
},
"child" : {
"resource" : "https://api.familysearch.org/platform/tree/persons/WRT-VSDX",
"resourceId" : "WRT-VSDX"
},
"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/FJP-M4RK/spouses
Accept: application/x-gedcomx-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
Response
HTTP/1.1 200 OK
Content-type: application/x-gedcomx-v1+xml
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/tree/persons/FJP-M4RK/spouses
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"?>
<gedcomx xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
<person id="LKM-MJNZ">
<link rel="person" href="https://api.familysearch.org/platform/tree/persons/LKM-MJNZ?flag=fsh"/>
<attribution>
<changeMessage>wikipedia knows</changeMessage>
</attribution>
<identifier type="http://gedcomx.org/Persistent">https://familysearch.org/ark:/61903/4:1:LKM-MJNZ</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>
<relationship type="http://gedcomx.org/Couple" id="crid">
<link rel="change-history" href="https://api.familysearch.org/platform/tree/couple-relationships/crid/changes?flag=fsh"/>
<link rel="collection" href="https://api.familysearch.org/collections/tree?flag=fsh"/>
<link rel="notes" href="https://api.familysearch.org/platform/tree/couple-relationships/crid/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/crid?flag=fsh"/>
<link rel="source-descriptions" href="https://api.familysearch.org/platform/tree/couple-relationships/crid/sources?flag=fsh"/>
<link rel="source-references" href="https://api.familysearch.org/platform/tree/couple-relationships/crid/source-references?flag=fsh"/>
<person1 resource="https://api.familysearch.org/platform/tree/persons/FJP-M4RK" resourceId="FJP-M4RK"/>
<person2 resource="https://api.familysearch.org/platform/tree/persons/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>
<fs:childAndParentsRelationship id="PPPX-PP0">
<fs:parent1 resource="#LKM-MJNZ" resourceId="LKM-MJNZ"/>
<fs:parent2 resource="https://api.familysearch.org/platform/tree/persons/FJP-M4RK" resourceId="FJP-M4RK"/>
<fs:child resource="https://api.familysearch.org/platform/tree/persons/WRT-VSDX" resourceId="WRT-VSDX"/>
<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>
</gedcomx>
Updated 5 days ago