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: Tue, 31 Mar 2015 20:49:35 GMT
Content-type: application/atom+xml
Last-modified: Tue, 31 Mar 2015 20:49:35 GMT
Etag: "vjfje78v34"
X-processing-time: 2

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<feed xmlns:gx="http://gedcomx.org/v1/" xmlns:fs="http://familysearch.org/v1/" xmlns="http://www.w3.org/2005/Atom">
    <id>uuid:7a1fa07d-be63-4762-90f5-3a50e832e95e</id>
    <link rel="next" href="https://familysearch.org/platform/tree/persons/P12-345/changes?from=1427834975721"/>
    <link rel="person" href="https://familysearch.org/platform/tree/persons/P12-345"/>
    <link rel="self" href="https://familysearch.org/platform/tree/persons/P12-345/changes"/>
    <title>Change History for Person P12-345</title>
    <updated>2015-03-31T14:49:35.717-06:00</updated>
    <entry>
        <fs:changeInfo objectType="http://gedcomx.org/Person" operation="http://familysearch.org/v1/Create" reason="because it was necessary"/>
        <contributor>
            <name>Mr. Contributor</name>
        </contributor>
        <id>1427834975720</id>
        <link rel="agent" href="https://familysearch.org/platform/users/agents/UKMGTY"/>
        <link rel="restore" href="https://familysearch.org/platform/tree/changes/171234/restore"/>
        <title>Person Created</title>
        <updated>2015-03-31T14:49:35.720-06:00</updated>
    </entry>
    <entry>
        <fs:changeInfo objectModifier="http://gedcomx.org/Person" objectType="http://gedcomx.org/Birth" operation="http://familysearch.org/v1/Create" reason="because it was necessary"/>
        <contributor>
            <name>Mr. Contributor</name>
        </contributor>
        <id>1427834975721</id>
        <link rel="agent" href="https://familysearch.org/platform/users/agents/UKMGTY"/>
        <link rel="restore" href="https://familysearch.org/platform/tree/changes/179807/restore"/>
        <title>Birth Added</title>
        <updated>2015-03-31T14:49:35.721-06:00</updated>
    </entry>
    <entry>
        <fs:changeInfo objectType="http://gedcomx.org/Person" operation="http://familysearch.org/v1/Delete" reason="because it was necessary"/>
        <contributor>
            <name>Mr. Contributor</name>
        </contributor>
        <id>1427834975721</id>
        <link rel="agent" href="https://familysearch.org/platform/users/agents/UKMGTY"/>
        <link rel="restore" href="https://familysearch.org/platform/tree/changes/791920/restore"/>
        <title>Person Removed</title>
        <updated>2015-03-31T14:49:35.721-06:00</updated>
    </entry>
</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: Tue, 31 Mar 2015 20:49:35 GMT
Content-type: application/x-gedcomx-atom+json
Last-modified: Tue, 31 Mar 2015 20:49:35 GMT
Etag: "vjfje78v34"
X-processing-time: 1

{
  "id" : "uuid:56cbfef5-513e-4a9a-92d9-e2497c67afbc",
  "links" : {
    "person" : {
      "href" : "https://familysearch.org/platform/tree/persons/P12-345"
    },
    "next" : {
      "href" : "https://familysearch.org/platform/tree/persons/P12-345/changes?from=1427834975781"
    },
    "self" : {
      "href" : "https://familysearch.org/platform/tree/persons/P12-345/changes"
    }
  },
  "title" : "Change History for Person P12-345",
  "updated" : 1427834975781,
  "entries" : [ {
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "id" : "1427834975781",
    "links" : {
      "restore" : {
        "href" : "https://familysearch.org/platform/tree/changes/151420/restore"
      },
      "agent" : {
        "href" : "https://familysearch.org/platform/users/agents/UKMGTY"
      }
    },
    "title" : "Person Created",
    "updated" : 1427834975781,
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Create",
      "objectType" : "http://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  }, {
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "id" : "1427834975781",
    "links" : {
      "restore" : {
        "href" : "https://familysearch.org/platform/tree/changes/162773/restore"
      },
      "agent" : {
        "href" : "https://familysearch.org/platform/users/agents/UKMGTY"
      }
    },
    "title" : "Birth Added",
    "updated" : 1427834975781,
    "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" : "1427834975781",
    "links" : {
      "restore" : {
        "href" : "https://familysearch.org/platform/tree/changes/493107/restore"
      },
      "agent" : {
        "href" : "https://familysearch.org/platform/users/agents/UKMGTY"
      }
    },
    "title" : "Person Removed",
    "updated" : 1427834975781,
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Delete",
      "objectType" : "http://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  } ]
}