Read Child-and-Parents Relationship Change History

This example request illustrates how to read the change history for a child-and-parents relationship. Each entry in the change history response provides details about what was changed, who performed the change, and an explanation of why the change was made if the reason was provided by the user.

JSON

Request

GET /platform/tree/child-and-parents-relationships/PC12-345/changes
Accept: application/x-gedcomx-atom+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
                
              

Response

HTTP/1.1 200 OK
Content-type: application/x-gedcomx-atom+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
                
                  {
  "id" : "uuid:random_uuid",
  "title" : "Change History for Parent Relationship Pair PC12-345",
  "updated" : 1543677067759,
  "links" : {
    "self" : {
      "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/PC12-345/changes?flag=fsh"
    },
    "relationship" : {
      "href" : "https://api.familysearch.org/platform/tree/child-and-parents-relationships/PC12-345?flag=fsh"
    }
  },
  "entries" : [ {
    "id" : "123Pid",
    "title" : "Child and Parents Relationship Created",
    "updated" : 1543677067759,
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "links" : {
      "agent" : {
        "href" : "https://api.familysearch.org/users/agents/UKMGTY?flag=fsh"
      },
      "restore" : {
        "href" : "https://api.familysearch.org/platform/tree/changes/chid/restore?flag=fsh"
      }
    },
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Create",
      "objectType" : "http://familysearch.org/v1/ChildAndParentsRelationship",
      "reason" : "because it was necessary"
    } ]
  }, {
    "id" : "123Pid",
    "title" : "Lineage Added",
    "updated" : 1543677067759,
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "links" : {
      "agent" : {
        "href" : "https://api.familysearch.org/users/agents/UKMGTY?flag=fsh"
      },
      "restore" : {
        "href" : "https://api.familysearch.org/platform/tree/changes/chid/restore?flag=fsh"
      }
    },
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Create",
      "objectType" : "http://gedcomx.org/Fact",
      "objectModifier" : "http://familysearch.org/v1/ChildAndParentsRelationship",
      "reason" : "because it was necessary"
    } ]
  }, {
    "id" : "123Pid",
    "title" : "Child and Parents Relationship Removed",
    "updated" : 1543677067759,
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "links" : {
      "agent" : {
        "href" : "https://api.familysearch.org/users/agents/UKMGTY?flag=fsh"
      },
      "restore" : {
        "href" : "https://api.familysearch.org/platform/tree/changes/chid/restore?flag=fsh"
      }
    },
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Delete",
      "objectType" : "http://familysearch.org/v1/ChildAndParentsRelationship",
      "reason" : "because it was necessary"
    } ]
  } ]
}
                
              

XML

Request

GET /platform/tree/child-and-parents-relationships/PC12-345/changes
Accept: application/atom+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
                
              

Response

HTTP/1.1 200 OK
Content-type: application/atom+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"?>
<feed xmlns:fs="http://familysearch.org/v1/" xmlns:gx="http://gedcomx.org/v1/" xmlns="http://www.w3.org/2005/Atom">
    <id>uuid:random_uuid</id>
    <link rel="relationship" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/PC12-345?flag=fsh"/>
    <link rel="self" href="https://api.familysearch.org/platform/tree/child-and-parents-relationships/PC12-345/changes?flag=fsh"/>
    <title>Change History for Parent Relationship Pair PC12-345</title>
    <updated>2018-12-01T08:11:07.759-07:00</updated>
    <entry>
        <fs:changeInfo objectType="http://familysearch.org/v1/ChildAndParentsRelationship" operation="http://familysearch.org/v1/Create" reason="because it was necessary"/>
        <contributor>
            <name>Mr. Contributor</name>
        </contributor>
        <id>123Pid</id>
        <link rel="agent" href="https://api.familysearch.org/users/agents/UKMGTY?flag=fsh"/>
        <link rel="restore" href="https://api.familysearch.org/platform/tree/changes/chid/restore?flag=fsh"/>
        <title>Child and Parents Relationship Created</title>
        <updated>2018-12-01T08:11:07.759-07:00</updated>
    </entry>
    <entry>
        <fs:changeInfo objectModifier="http://familysearch.org/v1/ChildAndParentsRelationship" objectType="http://gedcomx.org/Fact" operation="http://familysearch.org/v1/Create" reason="because it was necessary"/>
        <contributor>
            <name>Mr. Contributor</name>
        </contributor>
        <id>123Pid</id>
        <link rel="agent" href="https://api.familysearch.org/users/agents/UKMGTY?flag=fsh"/>
        <link rel="restore" href="https://api.familysearch.org/platform/tree/changes/chid/restore?flag=fsh"/>
        <title>Lineage Added</title>
        <updated>2018-12-01T08:11:07.759-07:00</updated>
    </entry>
    <entry>
        <fs:changeInfo objectType="http://familysearch.org/v1/ChildAndParentsRelationship" operation="http://familysearch.org/v1/Delete" reason="because it was necessary"/>
        <contributor>
            <name>Mr. Contributor</name>
        </contributor>
        <id>123Pid</id>
        <link rel="agent" href="https://api.familysearch.org/users/agents/UKMGTY?flag=fsh"/>
        <link rel="restore" href="https://api.familysearch.org/platform/tree/changes/chid/restore?flag=fsh"/>
        <title>Child and Parents Relationship Removed</title>
        <updated>2018-12-01T08:11:07.759-07:00</updated>
    </entry>
</feed>