Read Source References

This example request illustrates how to query for the source references that refer to a given source. This is useful, for example, in determining which persons in the Tree are citing the source.

JSON

Request

GET /platform/tree/source-references?description=DDDD-DDD
Accept: application/x-fs-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/x-fs-v1+json
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/tree/source-references
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked{
  "persons" : [ {
    "id" : "PPPP-PPP",
    "links" : {
      "person" : {
        "href" : "https://api.familysearch.org/platform/tree/persons/PPPP-PPP?flag=fsh"
      }
    },
    "sources" : [ {
      "id" : "fghij",
      "attribution" : {
        "contributor" : {
          "resource" : "https://api.familysearch.org/platform/users/agents/UUUU-UUU",
          "resourceId" : "UUUU-UUU"
        },
        "modified" : 987654321,
        "changeMessage" : "Dates and location match with other sources."
      },
      "links" : {
        "source-reference" : {
          "href" : "https://api.familysearch.org/platform/tree/persons/PPPP-PPP/source-references/srcrefid2?flag=fsh"
        }
      },
      "description" : "https://api.familysearch.org/platform/sources/descriptions/BBBB-BBB"
    } ]
  } ]
}

XML

Request

GET /platform/tree/source-references?description=DDDD-DDD
Accept: application/x-fs-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/x-fs-v1+xml
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/tree/source-references
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"?>
<fs:familysearch xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <person id="PPPP-PPP">
        <link rel="person" href="https://api.familysearch.org/platform/tree/persons/PPPP-PPP?flag=fsh"/>
        <source description="https://api.familysearch.org/platform/sources/descriptions/BBBB-BBB" id="fghij">
            <link rel="source-reference" href="https://api.familysearch.org/platform/tree/persons/PPPP-PPP/source-references/srcrefid2?flag=fsh"/>
            <attribution>
                <contributor resource="https://api.familysearch.org/platform/users/agents/UUUU-UUU" resourceId="UUUU-UUU"/>
                <modified>1970-01-12T03:20:54.321-07:00</modified>
                <changeMessage>Dates and location match with other sources.</changeMessage>
            </attribution>
        </source>
    </person>
</fs:familysearch>