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
Last-modified: Tue, 10 Jan 2017 21:55:47 GMT
Content-type: application/atom+xml
X-processing-time: 1
Etag: "vjfje78v34"
Vary: Accept-Encoding
Vary: Accept, Accept-Language, Accept-Encoding, Expect
Date: Tue, 10 Jan 2017 21:55:47 GMT
Cache-control: no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked

<?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:d9fcf3b0-f107-41e6-b72d-d2ec4fd2f9cc</id>
    <link rel="next" href="https://familysearch.org/platform/tree/persons/P12-345/changes?from=1484085347840"/>
    <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>2017-01-10T14:55:47.840-07: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>1484085347840</id>
        <link rel="agent" href="https://familysearch.org/users/agents/UKMGTY"/>
        <link rel="restore" href="https://familysearch.org/platform/tree/changes/760051/restore"/>
        <title>Person Created</title>
        <updated>2017-01-10T14:55:47.840-07: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>1484085347840</id>
        <link rel="agent" href="https://familysearch.org/users/agents/UKMGTY"/>
        <link rel="restore" href="https://familysearch.org/platform/tree/changes/106268/restore"/>
        <title>Birth Added</title>
        <updated>2017-01-10T14:55:47.840-07: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>1484085347840</id>
        <link rel="agent" href="https://familysearch.org/users/agents/UKMGTY"/>
        <link rel="restore" href="https://familysearch.org/platform/tree/changes/396458/restore"/>
        <title>Person Removed</title>
        <updated>2017-01-10T14:55:47.840-07: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
Last-modified: Tue, 10 Jan 2017 21:55:47 GMT
Content-type: application/x-gedcomx-atom+json
X-processing-time: 0
Etag: "vjfje78v34"
Vary: Accept-Encoding
Vary: Accept, Accept-Language, Accept-Encoding, Expect
Date: Tue, 10 Jan 2017 21:55:47 GMT
Cache-control: no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked

{
  "id" : "uuid:145713b4-c6d6-4cf6-80da-a5aae6c042c5",
  "title" : "Change History for Person P12-345",
  "updated" : 1484085347939,
  "links" : {
    "next" : {
      "href" : "https://familysearch.org/platform/tree/persons/P12-345/changes?from=1484085347939"
    },
    "person" : {
      "href" : "https://familysearch.org/platform/tree/persons/P12-345"
    },
    "self" : {
      "href" : "https://familysearch.org/platform/tree/persons/P12-345/changes"
    }
  },
  "entries" : [ {
    "id" : "1484085347939",
    "title" : "Person Created",
    "updated" : 1484085347939,
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "links" : {
      "agent" : {
        "href" : "https://familysearch.org/users/agents/UKMGTY"
      },
      "restore" : {
        "href" : "https://familysearch.org/platform/tree/changes/345811/restore"
      }
    },
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Create",
      "objectType" : "http://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  }, {
    "id" : "1484085347939",
    "title" : "Birth Added",
    "updated" : 1484085347939,
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "links" : {
      "agent" : {
        "href" : "https://familysearch.org/users/agents/UKMGTY"
      },
      "restore" : {
        "href" : "https://familysearch.org/platform/tree/changes/362585/restore"
      }
    },
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Create",
      "objectType" : "http://gedcomx.org/Birth",
      "objectModifier" : "http://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  }, {
    "id" : "1484085347939",
    "title" : "Person Removed",
    "updated" : 1484085347939,
    "contributors" : [ {
      "name" : "Mr. Contributor"
    } ],
    "links" : {
      "agent" : {
        "href" : "https://familysearch.org/users/agents/UKMGTY"
      },
      "restore" : {
        "href" : "https://familysearch.org/platform/tree/changes/191071/restore"
      }
    },
    "changeInfo" : [ {
      "operation" : "http://familysearch.org/v1/Delete",
      "objectType" : "http://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  } ]
}