Culture Authority

Use the Culture Authority service to get a list of and lookup cultures used by the other FamilySearch Authorities services.

URI

Use this URI to list all authority cultures:

https://api.familysearch.org/authorities/v1/culture

Use this URI to get an authority culture based on an id:

https://api.familysearch.org/authorities/v1/culture/[id]

You can request multiple cultures at once by adding multiple ids separated by commas following this pattern:


https://api.familysearch.org/authorities/v1/culture/[id],[id],[id],...

Note: You can request multiple cultures at the same time. Use the culture.max.ids parameter of the Authorities Properties service to obtain the maximum number of cultures that you can include in one request.

HTTP Method

GET

Parameters

None

Errors

Error Possible Causes Implemented
400 Bad Request: Generic client error or multiple client errors. May be caused by:
  • Requesting more cultures in one query than the API supports. Use the Authorities Properties service to see current limits.
Yes
401 Unauthorized: The user has invalid credentials or the session ID is missing, invalid, or has expired. This error also appears if the query string contains multiple question marks or the the session parameter contains letters in an incorrect case. Yes
404 Not Found: This request contained an invalid ID or a bad URI. No
500 Server Error: A generic server error or multiple server errors occurred. If you get this error, please report it through devsupport@familysearch.org. You can also post it to the FamilySearch Developer Network (FSDN). Yes
503 Service Unavailable: FamilySearch or the service that you are using is not currently available. Or you are being throttled. Yes

Example 1: Getting a List of All Cultures

Request

https://api.familysearch.org/authorities/v1/culture?{sessionId=}

Response

<?xml version="1.0" encoding="utf-8"?>
<authorities xmlns="http://api.familysearch.org/authorities/v1" xmlns:fsapi-v1="http://api.familysearch.org/v1" version="1.0.20080320.1495" statusMessage="OK" statusCode="200">
    <cultures>
        <culture id="2">Africa</culture>
        <culture id="3">Asia</culture>
        <culture id="4">British Isles</culture>
        <culture id="7">Caribbean Islands</culture>
        <culture id="5">Central America</culture>
        <culture id="22">China</culture>
        <culture id="6">Continental Europe</culture>
        <culture id="25">Cyrillic</culture>
        <culture id="8">Denmark</culture>
        <culture id="9">Finland</culture>
        <culture id="10">Germany</culture>
        <culture id="11">Iceland</culture>
        <culture id="23">Japan</culture>
        <culture id="24">Korea</culture>
        <culture id="12">Mexico</culture>
        <culture id="1">North America</culture>
        <culture id="14">Norway</culture>
        <culture id="19">Ocean Islands</culture>
        <culture id="15">South America</culture>
        <culture id="16">Southwest Europe</culture>
        <culture id="17">Southwest Pacific</culture>
        <culture id="18">Sweden</culture>
        <culture id="21">Unknown</culture>
        <culture id="20">Wales</culture>
        <culture id="13">World Miscellaneous</culture>
    </cultures>
</authorities>

Example 2: Looking Up a Culture by ID

Request

https://api.familysearch.org/authorities/v1/culture/1?{sessionId=}

Response

<?xml version="1.0" encoding="utf-8"?>
<authorities xmlns="http://api.familysearch.org/authorities/v1" xmlns:fsapi-v1="http://api.familysearch.org/v1" version="1.0.20080320.1495" statusMessage="OK" statusCode="200">
    <cultures>
        <culture id="1">North America</culture>
    </cultures>
</authorities>