Read Place Types

This example request illustrates how to get the list of place types. A place type is a type of place, such as a cemetery, city, state, etc.

JSON

Request

GET /platform/places/types
Accept: application/ld+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/ld+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{
  "@id" : "https://api.familysearch.org/platform/places/types",
  "title" : "Place Type List Title",
  "description" : "Place Type List Description",
  "elements" : [ {
    "id" : "1",
    "@id" : "https://api.familysearch.org/platform/places/types/1",
    "labels" : [ {
      "@language" : "en",
      "@value" : "Place Type 1 Title"
    } ],
    "descriptions" : [ {
      "@language" : "en",
      "@value" : "Place Type 1 Description"
    } ]
  }, {
    "id" : "2",
    "@id" : "https://api.familysearch.org/platform/places/types/2",
    "labels" : [ {
      "@language" : "en",
      "@value" : "Place Type 2 Title"
    } ],
    "descriptions" : [ {
      "@language" : "en",
      "@value" : "Place Type 2 Description"
    } ]
  } ],
  "http://www.w3.org/1999/02/22-rdf-syntax-ns#_1" : {
    "@id" : "https://api.familysearch.org/platform/places/types/1"
  },
  "http://www.w3.org/1999/02/22-rdf-syntax-ns#_2" : {
    "@id" : "https://api.familysearch.org/platform/places/types/2"
  },
  "@context" : {
    "title" : "http://purl.org/dc/terms/title",
    "description" : "http://purl.org/dc/terms/description",
    "elements" : {
      "@id" : "http://purl.org/dc/terms/hasPart",
      "@container" : "@list"
    },
    "id" : {
      "@id" : "http://purl.org/dc/terms/identifier"
    },
    "subclassOf" : {
      "@id" : "http://www.w3.org/2000/01/rdf-schema#subClassOf",
      "@type" : "@id"
    },
    "references" : {
      "@id" : "http://purl.org/dc/terms/references",
      "@type" : "@id"
    },
    "type" : {
      "@id" : "http://purl.org/dc/terms/type",
      "@type" : "@id"
    },
    "labels" : {
      "@id" : "http://www.w3.org/2000/01/rdf-schema#label"
    },
    "descriptions" : {
      "@id" : "http://www.w3.org/2000/01/rdf-schema#comment"
    }
  }
}

XML

Request

GET /platform/places/types
Accept: application/rdf+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

Response

HTTP/1.1 200 OK
Content-type: application/rdf+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'?>
<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#" xmlns:dc="http://purl.org/dc/terms/" xmlns:xml="http://www.w3.org/XML/1998/namespace">
  <Description about="https://api.familysearch.org/platform/places/types">
    <type resource="http://www.w3.org/1999/02/22-rdf-syntax-ns#Seq"/>
    <dc:title>Place Type List Title</dc:title>
    <dc:description>Place Type List Description</dc:description>
    <dc:hasPart parseType="Collection">
      <Description about="https://api.familysearch.org/platform/places/types/1"/>
      <Description about="https://api.familysearch.org/platform/places/types/2"/>
    </dc:hasPart>
    <li>
      <Description about="https://api.familysearch.org/platform/places/types/1">
        <dc:identifier>1</dc:identifier>
        <rdfs:label xml:lang="en">Place Type 1 Title</rdfs:label>
        <rdfs:comment xml:lang="en">Place Type 1 Description</rdfs:comment>
      </Description>
    </li>
    <li>
      <Description about="https://api.familysearch.org/platform/places/types/2">
        <dc:identifier>2</dc:identifier>
        <rdfs:label xml:lang="en">Place Type 2 Title</rdfs:label>
        <rdfs:comment xml:lang="en">Place Type 2 Description</rdfs:comment>
      </Description>
    </li>
  </Description>
</RDF>