Read Place Description with Related

This example request illustrates how to get a place description with its related Place Descriptions. A place description has a unique numeric identifier and is a representation of the logical place in a given time period, within a specific jurisdiction, with a specific official name.

JSON

Request

GET /platform/places/description/7344697/related
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
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Transfer-encoding: chunked{
  "places" : [ {
    "id" : "7344697",
    "lang" : "fr",
    "temporalDescription" : {
      "formal" : "+1968/"
    },
    "latitude" : 48.86024,
    "longitude" : 2.341109,
    "jurisdiction" : {
      "resource" : "#442102"
    },
    "links" : {
      "description-with-related" : {
        "href" : "https://api.familysearch.org/platform/places/description/7344697/related?flag=fsh"
      }
    },
    "identifiers" : {
      "http://gedcomx.org/Persistent" : [ "http://api.familysearch.org/platform/places/5061509" ]
    },
    "names" : [ {
      "value" : "Paris"
    } ],
    "display" : {
      "name" : "Paris",
      "fullName" : "Paris, Ville-de-Paris, District of the Paris Region, France",
      "type" : "Populated Place"
    }
  }, {
    "id" : "442102",
    "lang" : "fr",
    "jurisdiction" : {
      "resource" : "#204"
    },
    "links" : {
      "description-with-related" : {
        "href" : "https://api.familysearch.org/platform/places/description/442102/related?flag=fsh"
      }
    },
    "names" : [ {
      "value" : "Ville-de-Paris"
    } ]
  }, {
    "id" : "204",
    "lang" : "en",
    "links" : {
      "description-with-related" : {
        "href" : "https://api.familysearch.org/platform/places/description/204/related?flag=fsh"
      }
    },
    "names" : [ {
      "value" : "France"
    } ]
  } ]
}

XML

Request

GET /platform/places/description/7344697/related
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
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
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">
    <place xml:lang="fr" id="7344697">
        <link rel="description-with-related" href="https://api.familysearch.org/platform/places/description/7344697/related?flag=fsh"/>
        <identifier type="http://gedcomx.org/Persistent">http://api.familysearch.org/platform/places/5061509</identifier>
        <name>Paris</name>
        <temporalDescription>
            <formal>+1968/</formal>
        </temporalDescription>
        <latitude>48.86024</latitude>
        <longitude>2.341109</longitude>
        <jurisdiction resource="#442102"/>
        <display>
            <fullName>Paris, Ville-de-Paris, District of the Paris Region, France</fullName>
            <name>Paris</name>
            <type>Populated Place</type>
        </display>
    </place>
    <place xml:lang="fr" id="442102">
        <link rel="description-with-related" href="https://api.familysearch.org/platform/places/description/442102/related?flag=fsh"/>
        <name>Ville-de-Paris</name>
        <jurisdiction resource="#204"/>
    </place>
    <place xml:lang="en" id="204">
        <link rel="description-with-related" href="https://api.familysearch.org/platform/places/description/204/related?flag=fsh"/>
        <name>France</name>
    </place>
</fs:familysearch>