Read Place Authority

This example request illustrates how to read the Place Authority resource. The FamilySearch Place Authority resource contains FamilySearch's authoritative place information.

JSON

Request

GET /platform/collections/places
Accept: application/x-gedcomx-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/x-gedcomx-v1+json
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/collections/places
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, max-age=604800
Transfer-encoding: chunked{
  "description" : "#SD-FSPA",
  "sourceDescriptions" : [ {
    "id" : "SD-FSPA",
    "about" : "#FSPA",
    "componentOf" : {
      "description" : "https://api.familysearch.org/platform/collection"
    },
    "resourceType" : "http://gedcomx.org/Collection",
    "titles" : [ {
      "value" : "FamilySearch Place Authority"
    } ]
  } ],
  "collections" : [ {
    "id" : "FSPA",
    "title" : "FamilySearch Place Authority",
    "links" : {
      "logout" : {
        "href" : "https://api.familysearch.org/platform/logout?flag=fsh"
      },
      "place-type-groups" : {
        "template" : "https://api.familysearch.org/places/type-groups?flag=fst"
      },
      "place-types" : {
        "template" : "https://api.familysearch.org/places/types?flag=fst"
      },
      "place-group" : {
        "template" : "https://api.familysearch.org/places/groups/{pgid}?flag=fst"
      },
      "place-type" : {
        "template" : "https://api.familysearch.org/places/types/{ptid}?flag=fst"
      },
      "place-search" : {
        "template" : "https://api.familysearch.org/places/search?flag=fst"
      },
      "place-type-group" : {
        "template" : "https://api.familysearch.org/places/type-groups/{ptgid}?flag=fst"
      },
      "http://oauth.net/core/2.0/endpoint/token" : {
        "href" : "https://api.familysearch.org/oauth2/v3/token?flag=fsh"
      },
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/places?flag=fsh"
      },
      "record-collection-regions" : {
        "href" : "https://api.familysearch.org/platform/places/groups/15?flag=fsh"
      },
      "http://oauth.net/core/2.0/endpoint/authorize" : {
        "href" : "https://api.familysearch.org/oauth2/v3/authorization?flag=fsh"
      }
    }
  } ]
}

XML

Request

GET /platform/collections/places
Accept: application/x-gedcomx-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/x-gedcomx-v1+xml
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/collections/places
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, max-age=604800
Transfer-encoding: chunked<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<gedcomx xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom" description="#SD-FSPA">
    <sourceDescription about="#FSPA" resourceType="http://gedcomx.org/Collection" id="SD-FSPA">
        <componentOf description="https://api.familysearch.org/platform/collection"/>
        <title>FamilySearch Place Authority</title>
    </sourceDescription>
    <collection id="FSPA">
        <link rel="record-collection-regions" href="https://api.familysearch.org/platform/places/groups/15?flag=fsh"/>
        <link rel="http://oauth.net/core/2.0/endpoint/authorize" href="https://api.familysearch.org/oauth2/v3/authorization?flag=fsh"/>
        <link rel="http://oauth.net/core/2.0/endpoint/token" href="https://api.familysearch.org/oauth2/v3/token?flag=fsh"/>
        <link rel="logout" href="https://api.familysearch.org/platform/logout?flag=fsh"/>
        <link rel="place-group" template="https://api.familysearch.org/places/groups/{pgid}?flag=fst"/>
        <link rel="place-search" template="https://api.familysearch.org/places/search?flag=fst"/>
        <link rel="place-type-group" template="https://api.familysearch.org/places/type-groups/{ptgid}?flag=fst"/>
        <link rel="place-type-groups" template="https://api.familysearch.org/places/type-groups?flag=fst"/>
        <link rel="place-type" template="https://api.familysearch.org/places/types/{ptid}?flag=fst"/>
        <link rel="place-types" template="https://api.familysearch.org/places/types?flag=fst"/>
        <link rel="self" href="https://api.familysearch.org/platform/collections/places?flag=fsh"/>
        <title>FamilySearch Place Authority</title>
    </collection>
</gedcomx>