Search For Places Directly Under a Jurisdiction

This example request illustrates how to search for a place, requiring results to be limited to those that have a specific "parent" place. You can find places that exist within a particular jurisdiction or that existed at a certain time. This allows partners to create interactive user experiences, such as creating drop-down menus that allow users to see a list of possible places or creating maps with pins representing the places.

JSON

Request

GET /platform/places/search?q=name:Paris+%2BparentId:393946
Accept: application/x-gedcomx-atom+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/x-gedcomx-atom+json
X-processing-time: 3
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=86400
Transfer-encoding: chunked{
  "results" : 1,
  "index" : 0,
  "subtitle" : "Results of searching for places.",
  "title" : "Place Search Results",
  "entries" : [ {
    "content" : {
      "gedcomx" : {
        "places" : [ {
          "id" : "3988097",
          "lang" : "en",
          "latitude" : 42.22722,
          "longitude" : -111.40028,
          "jurisdiction" : {
            "resource" : "#393946"
          },
          "links" : {
            "description" : {
              "href" : "https://api.familysearch.org/platform/places/description/3988097?flag=fsh"
            }
          },
          "identifiers" : {
            "http://gedcomx.org/Persistent" : [ "http://api.familysearch.org/platform/places/344619" ]
          },
          "names" : [ {
            "value" : "Paris"
          } ],
          "display" : {
            "name" : "Paris",
            "fullName" : "Paris, Bear Lake, Idaho, United States",
            "type" : "City"
          }
        }, {
          "id" : "393946",
          "lang" : "en",
          "jurisdiction" : {
            "resource" : "#329"
          },
          "links" : {
            "description" : {
              "href" : "https://api.familysearch.org/platform/places/description/393946?flag=fsh"
            }
          },
          "names" : [ {
            "value" : "Bear Lake"
          } ]
        }, {
          "id" : "329",
          "lang" : "en",
          "jurisdiction" : {
            "resource" : "#1"
          },
          "links" : {
            "description" : {
              "href" : "https://api.familysearch.org/platform/places/description/329?flag=fsh"
            }
          },
          "names" : [ {
            "value" : "Idaho"
          } ]
        }, {
          "id" : "1",
          "lang" : "en",
          "links" : {
            "description" : {
              "href" : "https://api.familysearch.org/platform/places/description/1?flag=fsh"
            }
          },
          "names" : [ {
            "value" : "United States"
          } ]
        } ]
      }
    },
    "id" : "3988097",
    "score" : 100.0,
    "links" : {
      "description" : {
        "href" : "https://api.familysearch.org/platform/places/description/3988097?flag=fsh"
      }
    }
  } ]
}

XML

Request

GET /platform/places/search?q=name:Paris+%2BparentId:393946
Accept: application/atom+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/atom+xml
X-processing-time: 3
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=86400
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">
    <gx:results>1</gx:results>
    <gx:index>0</gx:index>
    <subtitle>Results of searching for places.</subtitle>
    <title>Place Search Results</title>
    <entry>
        <content type="application/x-gedcomx-v1+xml">
            <gx:gedcomx>
                <gx:place xml:lang="en" id="3988097">
                    <gx:link rel="description" href="https://api.familysearch.org/platform/places/description/3988097?flag=fsh"/>
                    <gx:identifier type="http://gedcomx.org/Persistent">http://api.familysearch.org/platform/places/344619</gx:identifier>
                    <gx:name>Paris</gx:name>
                    <gx:latitude>42.22722</gx:latitude>
                    <gx:longitude>-111.40028</gx:longitude>
                    <gx:jurisdiction resource="#393946"/>
                    <gx:display>
                        <gx:fullName>Paris, Bear Lake, Idaho, United States</gx:fullName>
                        <gx:name>Paris</gx:name>
                        <gx:type>City</gx:type>
                    </gx:display>
                </gx:place>
                <gx:place xml:lang="en" id="393946">
                    <gx:link rel="description" href="https://api.familysearch.org/platform/places/description/393946?flag=fsh"/>
                    <gx:name>Bear Lake</gx:name>
                    <gx:jurisdiction resource="#329"/>
                </gx:place>
                <gx:place xml:lang="en" id="329">
                    <gx:link rel="description" href="https://api.familysearch.org/platform/places/description/329?flag=fsh"/>
                    <gx:name>Idaho</gx:name>
                    <gx:jurisdiction resource="#1"/>
                </gx:place>
                <gx:place xml:lang="en" id="1">
                    <gx:link rel="description" href="https://api.familysearch.org/platform/places/description/1?flag=fsh"/>
                    <gx:name>United States</gx:name>
                </gx:place>
            </gx:gedcomx>
        </content>
        <id>3988097</id>
        <link rel="description" href="https://api.familysearch.org/platform/places/description/3988097?flag=fsh"/>
        <gx:score>100.0</gx:score>
    </entry>
</feed>