Read Person Change History

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

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: Sat, 01 Dec 2018 04:59:53 CET
Content-type: application/x-gedcomx-atom+json
X-processing-time: 3
Etag: "1543638712000"
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 Person P12-345",
  "updated" : 1543677067759,
  "links" : {
    "next" : {
      "href" : "https://api.familysearch.org/platform/tree/persons/P12-345/changes?flag=fsh&from=123Pid"
    },
    "person" : {
      "href" : "https://api.familysearch.org/platform/tree/persons/P12-345?flag=fsh"
    },
    "self" : {
      "href" : "https://api.familysearch.org/platform/tree/persons/P12-345/changes?flag=fsh"
    }
  },
  "entries" : [ {
    "id" : "123Pid",
    "title" : "Person 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://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  }, {
    "id" : "123Pid",
    "title" : "Birth 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/Birth",
      "objectModifier" : "http://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  }, {
    "id" : "123Pid",
    "title" : "Person 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://gedcomx.org/Person",
      "reason" : "because it was necessary"
    } ]
  } ]
}

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: Sat, 01 Dec 2018 04:59:53 CET
Content-type: application/atom+xml
X-processing-time: 3
Etag: "1543638712000"
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="next" href="https://api.familysearch.org/platform/tree/persons/P12-345/changes?flag=fsh&amp;from=123Pid"/>
    <link rel="person" href="https://api.familysearch.org/platform/tree/persons/P12-345?flag=fsh"/>
    <link rel="self" href="https://api.familysearch.org/platform/tree/persons/P12-345/changes?flag=fsh"/>
    <title>Change History for Person P12-345</title>
    <updated>2018-12-01T08:11:07.759-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>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>Person Created</title>
        <updated>2018-12-01T08:11:07.759-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>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>Birth Added</title>
        <updated>2018-12-01T08:11:07.759-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>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>Person Removed</title>
        <updated>2018-12-01T08:11:07.759-07:00</updated>
    </entry>
</feed>