Name Authority

Use the Name Authority service to get representations of authoritative name information from FamilySearch.

URI

Use this URI to search and segment names:

https://api.familysearch.org/authorities/v1/name?

HTTP Method

GET

Parameters

&name:
Specifys person’s full name.
Note: Use the name.max.names parameter of the Authorities Properties Authority service to obtain the maximum number of names that you can include in one request.
&culture:
Specifies the culture of the name as supplied by Culture Authority service. The default is 1. (optional)
&variants:
Specifies whether place authority should return name variants. The default is false. It is a boolean search.

Errors

Error Possible Causes Implemented
400 Bad Request: Generic client error or multiple client errors. May be caused by:
  • Invalid parameter or parameter value
  • Requesting more names 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
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: Request with Variants

Request

https://api.familysearch.org/authorities/v1/name?name=John+Doe&culture=1&variants=true&sessionId={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.4.20091022.4995" statusMessage="OK" statusCode="200">
  <names version="3.0.3" count="1">
    <name original="John Doe">
      <pieces>
        <piece type="Given" text="John">
          <predelimiters></predelimiters>
          <value>John</value>
          <postdelimiters></postdelimiters>
          <encodings>
            <nysiis>JAN</nysiis>
            <phondex>xaN</phondex>
            <soundex>J500</soundex>
          </encodings>
          <variants id="780080" culture="1">
            <variant>ansas</variant>
            <variant>ansis</variant>
            <variant>ansk</variant>
            <variant>anske</variant>
            <variant>anskis</variant>
            <variant>boen</variant>
            <variant>chiang</variant>
            <variant>cleinhans</variant>
            <variant>eion</variant>
            <variant>eoghan</variant>
            <variant>eoin</variant>
            <variant>gei</variant>
            <variant>geovani</variant>
            <variant>gianni</variant>
            <variant>giannis</variant>
            <variant>giavanni</variant>
            <variant>gioan</variant>
            <variant>gioanni</variant>
            <variant>gion</variant>
            <variant>giov</variant>
            <variant>giovan</variant>
            <variant>giovanantonio</variant>
            <variant>giovandomenico</variant>
            <variant>giovane</variant>
            <variant>giovani</variant>
            <variant>giovannantonio</variant>
            <variant>giovanne</variant>
            <variant>giovanni</variant>
            <variant>giovannie</variant>
            <variant>giovannino</variant>
            <variant>giovanno</variant>
            <variant>giovanny</variant>
            <variant>giovano</variant>
            <variant>giovonni</variant>
            <variant>givanni</variant>
            <variant>goen</variant>
            <variant>gohn</variant>
            <variant>goi</variant>
            <variant>goin</variant>
            <variant>going</variant>
            <variant>grosshans</variant>
            <variant>gwion</variant>
            <variant>gwon</variant>
            <variant>gyon</variant>
            <variant>haeni</variant>
            <variant>haens</variant>
            <variant>hancke</variant>
            <variant>hanneken</variant>
            <variant>hanness</variant>
            <variant>hannsen</variant>
            <variant>hannss</variant>
            <variant>hannssen</variant>
            <variant>hannsz</variant>
            <variant>hans_</variant>
            <variant>hanseli</variant>
            <variant>hansens</variant>
            <variant>hanser</variant>
            <variant>hanses</variant>
            <variant>hansgeorg</variant>
            <variant>hansli</variant>
            <variant>hanspeter</variant>
            <variant>hansruedi</variant>
            <variant>hanssen</variant>
            <variant>hanus</variant>
            <variant>hanzel</variant>
            <variant>hensell</variant>
            <variant>hensli</variant>
            <variant>henzel</variant>
            <variant>hns</variant>
            <variant>hohan</variant>
            <variant>hohannes</variant>
            <variant>hss</variant>
            <variant>hyon</variant>
            <variant>ieuan</variant>
            <variant>iewan</variant>
            <variant>ihon</variant>
            <variant>ino</variant>
            <variant>inoe</variant>
            <variant>ioanis</variant>
            <variant>ioannes</variant>
            <variant>iohannes</variant>
            <variant>iohn</variant>
            <variant>ion</variant>
            <variant>ioun</variant>
            <variant>istvany</variant>
            <variant>iuan</variant>
            <variant>ivanes</variant>
            <variant>ivannes</variant>
            <variant>iwar</variant>
            <variant>jaannes</variant>
            <variant>jaans</variant>
            <variant>jahan</variant>
            <variant>jahannes</variant>
            <variant>jahez</variant>
            <variant>jahn</variant>
            <variant>jahon</variant>
            <variant>jan_</variant>
            <variant>janann</variant>
            <variant>janek</variant>
            <variant>janez</variant>
            <variant>janin</variant>
            <variant>janko</variant>
            <variant>janne_</variant>
            <variant>jannik</variant>
            <variant>janses</variant>
            <variant>janshen</variant>
            <variant>janson</variant>
            <variant>janss</variant>
            <variant>janssen</variant>
            <variant>jasch</variant>
            <variant>jaun</variant>
            <variant>jean_</variant>
            <variant>jeanbaptiste</variant>
            <variant>jeanes</variant>
            <variant>jeannes</variant>
            <variant>jeanton</variant>
            <variant>jeau</variant>
            <variant>jendris</variant>
            <variant>jendrzey</variant>
            <variant>jenze</variant>
            <variant>jeon</variant>
            <variant>jesko</variant>
            <variant>jh</variant>
            <variant>jha</variant>
            <variant>jhan</variant>
            <variant>jhann</variant>
            <variant>jhanne</variant>
            <variant>jhe</variant>
            <variant>jhes</variant>
            <variant>jhn</variant>
            <variant>jhnes</variant>
            <variant>jhnis</variant>
            <variant>jho</variant>
            <variant>jhoannes</variant>
            <variant>jhoannis</variant>
            <variant>jhois</variant>
            <variant>jhon</variant>
            <variant>jhone</variant>
            <variant>jhonn</variant>
            <variant>jhonnie</variant>
            <variant>jhonny</variant>
            <variant>jhs</variant>
            <variant>jian</variant>
            <variant>jis</variant>
            <variant>jiss</variant>
            <variant>jn</variant>
            <variant>jna</variant>
            <variant>jne</variant>
            <variant>jno</variant>
            <variant>jns</variant>
            <variant>jo'em</variant>
            <variant>jo'es</variant>
            <variant>jo'is</variant>
            <variant>joaannes</variant>
            <variant>joae</variant>
            <variant>joaennes</variant>
            <variant>joaes</variant>
            <variant>joahan</variant>
            <variant>joahann</variant>
            <variant>joahannes</variant>
            <variant>joahn</variant>
            <variant>joahnn</variant>
            <variant>joahnnes</variant>
            <variant>joahua</variant>
            <variant>joai</variant>
            <variant>joais</variant>
            <variant>joan_</variant>
            <variant>joanes</variant>
            <variant>joanis</variant>
            <variant>joaniz</variant>
            <variant>joannam</variant>
            <variant>joanne_</variant>
            <variant>joannem</variant>
            <variant>joannen</variant>
            <variant>joannes</variant>
            <variant>joanness</variant>
            <variant>joannesz</variant>
            <variant>joanni</variant>
            <variant>joannim</variant>
            <variant>joannis</variant>
            <variant>joanniss</variant>
            <variant>joannnes</variant>
            <variant>joanno</variant>
            <variant>joannos</variant>
            <variant>joanns</variant>
            <variant>joannum</variant>
            <variant>joannus</variant>
            <variant>joano</variant>
            <variant>joans</variant>
            <variant>joanus</variant>
            <variant>jochann</variant>
            <variant>joe_</variant>
            <variant>joean</variant>
            <variant>joem</variant>
            <variant>joen</variant>
            <variant>joena</variant>
            <variant>joennes</variant>
            <variant>joer</variant>
            <variant>joh</variant>
            <variant>joh'es</variant>
            <variant>joh's</variant>
            <variant>joha</variant>
            <variant>johaan</variant>
            <variant>johaes</variant>
            <variant>johah</variant>
            <variant>johais</variant>
            <variant>joham</variant>
            <variant>johamm</variant>
            <variant>johamus</variant>
            <variant>johan</variant>
            <variant>johanae</variant>
            <variant>johanan</variant>
            <variant>johananes</variant>
            <variant>johanas</variant>
            <variant>johanes</variant>
            <variant>johaness</variant>
            <variant>johani</variant>
            <variant>johanii</variant>
            <variant>johanis</variant>
            <variant>johanm</variant>
            <variant>johann</variant>
            <variant>johannaes</variant>
            <variant>johannan</variant>
            <variant>johannas</variant>
            <variant>johanne_</variant>
            <variant>johannees</variant>
            <variant>johannem</variant>
            <variant>johannen</variant>
            <variant>johanner</variant>
            <variant>johannes</variant>
            <variant>johannes_</variant>
            <variant>johannese</variant>
            <variant>johannesen</variant>
            <variant>johanneson</variant>
            <variant>johanness</variant>
            <variant>johannesz</variant>
            <variant>johanni</variant>
            <variant>johannijs</variant>
            <variant>johannis</variant>
            <variant>johanniss</variant>
            <variant>johannn</variant>
            <variant>johannnes</variant>
            <variant>johanno</variant>
            <variant>johannos</variant>
            <variant>johanns</variant>
            <variant>johannsen</variant>
            <variant>johannss</variant>
            <variant>johannum</variant>
            <variant>johannus</variant>
            <variant>johanny</variant>
            <variant>johans</variant>
            <variant>johanson</variant>
            <variant>johanss</variant>
            <variant>johansson</variant>
            <variant>johanus</variant>
            <variant>johany</variant>
            <variant>johas</variant>
            <variant>johaun</variant>
            <variant>johe</variant>
            <variant>johem</variant>
            <variant>johen</variant>
            <variant>johenn</variant>
            <variant>johennes</variant>
            <variant>johens</variant>
            <variant>johes</variant>
            <variant>johh</variant>
            <variant>johhan</variant>
            <variant>johhann</variant>
            <variant>johhannes</variant>
            <variant>johhn</variant>
            <variant>johhnie</variant>
            <variant>johi</variant>
            <variant>johin</variant>
            <variant>johis</variant>
            <variant>johm</variant>
            <variant>john</variant>
            <variant>john'</variant>
            <variant>john's</variant>
            <variant>johna</variant>
            <variant>johnannes</variant>
            <variant>johne</variant>
            <variant>johnes</variant>
            <variant>johney</variant>
            <variant>johni</variant>
            <variant>johnie</variant>
            <variant>johnis</variant>
            <variant>johnn</variant>
            <variant>johnnas</variant>
            <variant>johnne</variant>
            <variant>johnnes</variant>
            <variant>johnney</variant>
            <variant>johnni</variant>
            <variant>johnnie</variant>
            <variant>johnnis</variant>
            <variant>johnny</variant>
            <variant>johns</variant>
            <variant>johnse</variant>
            <variant>johnty</variant>
            <variant>johny</variant>
            <variant>joho</variant>
            <variant>johon</variant>
            <variant>johones</variant>
            <variant>johonn</variant>
            <variant>johonnes</variant>
            <variant>johonnis</variant>
            <variant>johons</variant>
            <variant>johs</variant>
            <variant>johss</variant>
            <variant>johu</variant>
            <variant>johua</variant>
            <variant>johus</variant>
            <variant>johy</variant>
            <variant>joi</variant>
            <variant>joihn</variant>
            <variant>joiner</variant>
            <variant>jojn</variant>
            <variant>jom</variant>
            <variant>jon</variant>
            <variant>jonae</variant>
            <variant>jonam</variant>
            <variant>jonannes</variant>
            <variant>jone</variant>
            <variant>joner</variant>
            <variant>jones</variant>
            <variant>jonhn</variant>
            <variant>joni</variant>
            <variant>jonn</variant>
            <variant>jonne</variant>
            <variant>jonnes</variant>
            <variant>jonney</variant>
            <variant>jonnie</variant>
            <variant>jonns</variant>
            <variant>jonny</variant>
            <variant>jons</variant>
            <variant>jonss</variant>
            <variant>joohn</variant>
            <variant>joon</variant>
            <variant>joonne</variant>
            <variant>joop</variant>
            <variant>joun</variant>
            <variant>jouni</variant>
            <variant>jovannes</variant>
            <variant>joyn</variant>
            <variant>joyner</variant>
            <variant>joynes</variant>
            <variant>ju</variant>
            <variant>jua</variant>
            <variant>juam</variant>
            <variant>juan</variant>
            <variant>juana_</variant>
            <variant>juancho</variant>
            <variant>juande</variant>
            <variant>juanes</variant>
            <variant>juanico</variant>
            <variant>juanillo</variant>
            <variant>juanito</variant>
            <variant>juanto</variant>
            <variant>juao</variant>
            <variant>juen</variant>
            <variant>juh</variant>
            <variant>juhan</variant>
            <variant>juhana</variant>
            <variant>juhani</variant>
            <variant>juhannes</variant>
            <variant>juhn</variant>
            <variant>juian</variant>
            <variant>juin</variant>
            <variant>jukka</variant>
            <variant>juner</variant>
            <variant>jungen</variant>
            <variant>junghans</variant>
            <variant>junghanss</variant>
            <variant>junghenn</variant>
            <variant>juni</variant>
            <variant>juoan</variant>
            <variant>jussi</variant>
            <variant>kleinhans</variant>
            <variant>klihans</variant>
            <variant>klinhans</variant>
            <variant>klyhans</variant>
            <variant>ohan</variant>
            <variant>schone</variant>
            <variant>shone</variant>
            <variant>shun</variant>
            <variant>syon</variant>
            <variant>tannis</variant>
            <variant>vanja</variant>
            <variant>vanni</variant>
            <variant>wion</variant>
            <variant>yann</variant>
            <variant>yannick</variant>
            <variant>yoan</variant>
            <variant>yoann</variant>
            <variant>yohan</variant>
            <variant>yohann</variant>
            <variant>yohannes</variant>
            <variant>yohn</variant>
            <variant>yon</variant>
            <variant>yonas</variant>
            <variant>yonny</variant>
            <variant>yono</variant>
            <variant>yony</variant>
            <variant>yuan</variant>
            <variant>yvan</variant>
            <variant>zuan</variant>
          </variants>
        </piece>
        <piece type="Family" text="Doe">
          <predelimiters></predelimiters>
          <value>Doe</value>
          <postdelimiters></postdelimiters>
          <encodings>
            <nysiis>D</nysiis>
            <phondex>daY</phondex>
            <soundex>D000</soundex>
          </encodings>
          <variants id="822827" culture="1">
            <variant>dawa</variant>
            <variant>dawe</variant>
            <variant>dawie</variant>
            <variant>deau</variant>
            <variant>do</variant>
            <variant>doa</variant>
            <variant>doe</variant>
            <variant>dohe</variant>
            <variant>doi</variant>
            <variant>doio</variant>
            <variant>dojahn</variant>
            <variant>dou</variant>
            <variant>dow</variant>
            <variant>dowa</variant>
            <variant>dowah</variant>
            <variant>doy</variant>
            <variant>doye</variant>
            <variant>doyou</variant>
            <variant>mcdow</variant>
          </variants>
        </piece>
      </pieces>
      <fields>
        <field type="Given" text="John" />
        <field type="Family" text="Doe" />
      </fields>
    </name>
  </names>
</authorities>

Example: Request with Only a Name

Request

https://api.familysearch.org/authorities/v1/name?name=John+Smith&{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.4.20090403.0" statusMessage="OK" statusCode="200">
    <names version="3.0.3" count="1">
        <name original="John Smith">
            <pieces>
                <piece value="John" type="Given" text="John" predelimiters="" postdelimiters=" ">
                    <encodings>
                        <nysiis>JAN</nysiis>
                        <phondex>xaN</phondex>
                        <soundex>J500</soundex>
                    </encodings>
                </piece>
                <piece value="Smith" type="Family" text="Smith" predelimiters="" postdelimiters="">
                    <encodings>
                        <nysiis>SNATH</nysiis>
                        <phondex>SMaT</phondex>
                        <soundex>S530</soundex>
                    </encodings>
                </piece>
            </pieces>
            <fields>
                <field type="Given" text="John"/>
                <field type="Family" text="Smith"/>
            </fields>
        </name>
    </names>
</authorities>