Read FamilySearch Collections

This example request illustrates how to read the list of all collections described by the FamilySearch API. This is used to discover what is being made available by the FamilySearch API.

JSON

Request

GET /platform/collections
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
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, max-age=604800
Transfer-encoding: chunked{
  "collections" : [ {
    "id" : "FSFT",
    "title" : "FamilySearch Family Tree",
    "links" : {
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/tree?flag=fsc"
      }
    }
  }, {
    "id" : "FSHRA",
    "title" : "FamilySearch Historical Records Archive",
    "links" : {
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/records?flag=fsc"
      }
    }
  }, {
    "id" : "FSUDS",
    "title" : "FamilySearch User-Defined Sources",
    "links" : {
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/sources?flag=fsc"
      }
    }
  }, {
    "id" : "FSMEM",
    "title" : "FamilySearch Memories",
    "links" : {
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/memories?flag=fsc"
      }
    }
  }, {
    "id" : "FSDF",
    "title" : "FamilySearch Discussions",
    "links" : {
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/discussions?flag=fsc"
      }
    }
  }, {
    "id" : "FSPA",
    "title" : "FamilySearch Place Authority",
    "links" : {
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/places?flag=fsc"
      }
    }
  }, {
    "id" : "FSDA",
    "title" : "FamilySearch Date Authority",
    "links" : {
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/dates?flag=fsc"
      }
    }
  }, {
    "id" : "FSCV",
    "title" : "FamilySearch Controlled Vocabulary",
    "links" : {
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/vocab?flag=fsc"
      }
    }
  }, {
    "id" : "FSG",
    "title" : "FamilySearch Genealogies",
    "links" : {
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/genealogies?flag=fsc"
      }
    }
  }, {
    "id" : "FSNA",
    "title" : "FamilySearch Name Authority",
    "links" : {
      "self" : {
        "href" : "https://api.familysearch.org/platform/collections/names?flag=fsc"
      }
    }
  } ]
}

XML

Request

GET /platform/collections
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
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">
    <collection id="FSFT">
        <link rel="self" href="https://api.familysearch.org/platform/collections/tree?flag=fsc"/>
        <title>FamilySearch Family Tree</title>
    </collection>
    <collection id="FSHRA">
        <link rel="self" href="https://api.familysearch.org/platform/collections/records?flag=fsc"/>
        <title>FamilySearch Historical Records Archive</title>
    </collection>
    <collection id="FSUDS">
        <link rel="self" href="https://api.familysearch.org/platform/collections/sources?flag=fsc"/>
        <title>FamilySearch User-Defined Sources</title>
    </collection>
    <collection id="FSMEM">
        <link rel="self" href="https://api.familysearch.org/platform/collections/memories?flag=fsc"/>
        <title>FamilySearch Memories</title>
    </collection>
    <collection id="FSDF">
        <link rel="self" href="https://api.familysearch.org/platform/collections/discussions?flag=fsc"/>
        <title>FamilySearch Discussions</title>
    </collection>
    <collection id="FSPA">
        <link rel="self" href="https://api.familysearch.org/platform/collections/places?flag=fsc"/>
        <title>FamilySearch Place Authority</title>
    </collection>
    <collection id="FSDA">
        <link rel="self" href="https://api.familysearch.org/platform/collections/dates?flag=fsc"/>
        <title>FamilySearch Date Authority</title>
    </collection>
    <collection id="FSCV">
        <link rel="self" href="https://api.familysearch.org/platform/collections/vocab?flag=fsc"/>
        <title>FamilySearch Controlled Vocabulary</title>
    </collection>
    <collection id="FSG">
        <link rel="self" href="https://api.familysearch.org/platform/collections/genealogies?flag=fsc"/>
        <title>FamilySearch Genealogies</title>
    </collection>
    <collection id="FSNA">
        <link rel="self" href="https://api.familysearch.org/platform/collections/names?flag=fsc"/>
        <title>FamilySearch Name Authority</title>
    </collection>
</gedcomx>