Read Person Change History

This example request illustrates how to read the change history for a person.

XML

Request

GET /platform/tree/persons/P12-345/changes
Accept: application/atom+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Transfer-encoding: chunked
Cache-control: no-transform, must-revalidate, max-age=0
Vary: Accept-Encoding
Vary: Accept, Accept-Language, Accept-Encoding, Expect
Date: Wed, 20 Apr 2016 18:58:15 GMT
Content-type: application/atom+xml
Last-modified: Wed, 20 Apr 2016 18:58:15 GMT
Etag: "vjfje78v34"
X-processing-time: 1

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns4:feed xmlns:gx="http://gedcomx.org/v1/" xmlns:fs="http://familysearch.org/v1/" xmlns:ns4="http://www.w3.org/2005/Atom">
    <ns4:id>uuid:4e753c2c-c08d-4ca9-bee1-85b28570011d</ns4:id>
    <ns4:link rel="next" href="https://familysearch.org/platform/tree/persons/P12-345/changes?from=1461178695072"/>
    <ns4:link rel="person" href="https://familysearch.org/platform/tree/persons/P12-345"/>
    <ns4:link rel="self" href="https://familysearch.org/platform/tree/persons/P12-345/changes"/>
    <ns4:title>Change History for Person P12-345</ns4:title>
    <ns4:updated>2016-04-20T12:58:15.072-06:00</ns4:updated>
    <ns4:entry>
        <fs:changeInfo objectType="http://gedcomx.org/Person" operation="http://familysearch.org/v1/Create" reason="because it was necessary"/>
        <ns4:contributor>
            <ns4:name>Mr. Contributor</ns4:name>
        </ns4:contributor>
        <ns4:id>1461178695072</ns4:id>
        <ns4:link rel="agent" href="https://familysearch.org/platform/users/agents/UKMGTY"/>
        <ns4:link rel="restore" href="https://familysearch.org/platform/tree/changes/202553/restore"/>
        <ns4:title>Person Created</ns4:title>
        <ns4:updated>2016-04-20T12:58:15.072-06:00</ns4:updated>
    </ns4:entry>
    <ns4:entry>
        <fs:changeInfo objectModifier="http://gedcomx.org/Person" objectType="http://gedcomx.org/Birth" operation="http://familysearch.org/v1/Create" reason="because it was necessary"/>
        <ns4:contributor>
            <ns4:name>Mr. Contributor</ns4:name>
        </ns4:contributor>
        <ns4:id>1461178695072</ns4:id>
        <ns4:link rel="agent" href="https://familysearch.org/platform/users/agents/UKMGTY"/>
        <ns4:link rel="restore" href="https://familysearch.org/platform/tree/changes/124501/restore"/>
        <ns4:title>Birth Added</ns4:title>
        <ns4:updated>2016-04-20T12:58:15.072-06:00</ns4:updated>
    </ns4:entry>
    <ns4:entry>
        <fs:changeInfo objectType="http://gedcomx.org/Person" operation="http://familysearch.org/v1/Delete" reason="because it was necessary"/>
        <ns4:contributor>
            <ns4:name>Mr. Contributor</ns4:name>
        </ns4:contributor>
        <ns4:id>1461178695072</ns4:id>
        <ns4:link rel="agent" href="https://familysearch.org/platform/users/agents/UKMGTY"/>
        <ns4:link rel="restore" href="https://familysearch.org/platform/tree/changes/202707/restore"/>
        <ns4:title>Person Removed</ns4:title>
        <ns4:updated>2016-04-20T12:58:15.072-06:00</ns4:updated>
    </ns4:entry>
</ns4:feed>

JSON

Request

GET /platform/tree/persons/P12-345/changes
Accept: application/x-gedcomx-atom+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Transfer-encoding: chunked
Cache-control: no-transform, must-revalidate, max-age=0
Vary: Accept-Encoding
Vary: Accept, Accept-Language, Accept-Encoding, Expect
Date: Wed, 20 Apr 2016 18:58:15 GMT
Content-type: application/x-gedcomx-atom+json
Last-modified: Wed, 20 Apr 2016 18:58:15 GMT
Etag: "vjfje78v34"
X-processing-time: 1

{
  "id" : "uuid:2ec93b3c-c777-4cd3-9247-7e064c65633a",
  "links" : {
    "person" : {
      "href" : "https://familysearch.org/platform/tree/persons/P12-345"
    },
    "next" : {
      "href" : "https://familysearch.org/platform/tree/persons/P12-345/changes?from=1461178695172"
    },
    "self" : {
      "href" : "https://familysearch.org/platform/tree/persons/P12-345/changes"
    }
  },
  "title" : "Change History for Person P12-345",
  "updated" : 1461178695172,
  "entries" : [ {
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "id" : "1461178695172",
    "links" : {
      "restore" : {
        "href" : "https://familysearch.org/platform/tree/changes/111877/restore"
      },
      "agent" : {
        "href" : "https://familysearch.org/platform/users/agents/UKMGTY"
      }
    },
    "title" : "Person Created",
    "updated" : 1461178695172,
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Create",
      "objectType" : "http://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  }, {
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "id" : "1461178695172",
    "links" : {
      "restore" : {
        "href" : "https://familysearch.org/platform/tree/changes/202117/restore"
      },
      "agent" : {
        "href" : "https://familysearch.org/platform/users/agents/UKMGTY"
      }
    },
    "title" : "Birth Added",
    "updated" : 1461178695172,
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Create",
      "objectType" : "http://gedcomx.org/Birth",
      "objectModifier" : "http://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  }, {
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "id" : "1461178695172",
    "links" : {
      "restore" : {
        "href" : "https://familysearch.org/platform/tree/changes/924080/restore"
      },
      "agent" : {
        "href" : "https://familysearch.org/platform/users/agents/UKMGTY"
      }
    },
    "title" : "Person Removed",
    "updated" : 1461178695172,
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Delete",
      "objectType" : "http://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  } ]
}