Resources

Artifacts

No resources are available.

Authentication

Authentication Guide Guide for authentication.
Access Token POST The access token resource is used to obtain an access token.
Logout POST The Logout resource is used to delete an access token, effectively logging a user out.
Authorization Code GET, POST The authorization resource is used to initiate the process for obtaining an authorization code that can be used to obtain an access token.
Deprecated OAuth 1 Guide OAuth 1 is the old way to authenticate.

Authorities

Date GET Interpret a date.
Name Authority GET Get representations of authoritative name information from FamilySearch.
Culture Authority GET Get a list of and lookup cultures used by the other FamilySearch Authorities services.
Authorities Properties GET Get a list of name/value pairs that pertain to the Authorities module.
Deprecated Place Authority GET Get representations of authoritative place information from FamilySearch. This API is deprecated in favor of the new Places API.
Deprecated Date Authority GET Interpret dates using FamilySearch.

Change History

Person Change History HEAD, GET The Person Change History resource provides a list of changes for a person. Each entry in the change history provides details about what was changed, who performed the change, and an explanation of...
Child-and-Parents Relationship Change History HEAD, GET This Child-and-Parents Relationship Change History resource provides a list of changes for a child-and-parents relationship. Each entry in the change history provides details about what was changed,...
Couple Relationship Change History HEAD, GET The Couple Relationship Change History resource provides a list of changes for a couple relationship. Each entry in the change history provides details about what was changed, who performed the...
Restore Change POST The Restore Change resource enables a user to rollback a particular change. This includes restoring to a previous state after it was modified, deleting a resource that was added, or restoring a resource...

Collections

Home GET The Home resource is the description of the entire FamilySearch API as a collection.
FamilySearch Collections GET The FamilySearch Collections resource is the list of all collections available at FamilySearch.org.
FamilySearch Controlled Vocabulary GET The FamilySearch Controlled Vocabulary resource describes the collection of all controlled vocabulary elements managed by FamilySearch.
FamilySearch Family Tree GET The FamilySearch Family Tree resource describes the FamilySearch Family Tree as a collection.
FamilySearch Dates GET The FamilySearch Date Authority resource describes the date authority as a collection.
FamilySearch Discussions GET The FamilySearch Discussions resource describes as a collection the set of all discussions about FamilySearch resources.
FamilySearch Memories GET The FamilySearch Memories resource describes as a collection the set of all memories provided by users to FamilySearch.
FamilySearch User-Defined Sources GET The FamilySearch User-Defined Sources resource describes as a collection the set of all sources defined by FamilySearch users.
FamilySearch Place Authority GET The FamilySearch Place Authority resource is the collection of all descriptions of places maintained by FamilySearch.
FamilySearch Historical Records Archive GET The FamilySearch Historical Records Archive resource describes the FamilySearch Historical Records Archive as a collection.
Prototype FamilySearch Genealogies GET The FamilySearch Genealogies resource defines the collection that describes the genealogies API.
Deprecated Discovery GET The Discovery resource is an index of the links for the FamilySearch Family Tree. It is being replaced by the FamilySearch Family Tree resource.

Discussions

Discussions POST The Discussions resource is used to create a discussion.
Discussion HEAD, GET, POST, DELETE The Discussion resource is used to read and to delete a discussion.
Comments GET, POST The Comments resource provides the list of comments for a specific discussion, as well as the mechanism to add and update comments in the discussion.
Comment DELETE The Comment resource defines the interface that is used to delete a specific comment.

Genealogies

Prototype Genealogies Tree GET, POST, DELETE A tree in FamilySearch genealogies.
Prototype Genealogies Trees POST Trees in FamilySearch genealogies.
Prototype Genealogies Person GET, POST, DELETE A person in FamilySearch genealogies.
Prototype Genealogies Persons GET, POST Persons a Tree in FamilySearch genealogies.
Prototype Genealogies Source Description GET A Source Description in FamilySearch genealogies.
Prototype Genealogies Relationship DELETE A relationship between two persons in FamilySearch genealogies.
Prototype Genealogies Relationships POST Relationships between two persons in FamilySearch genealogies.
Prototype Genealogies Person Matches GET Record matches for a Person in FamilySearch genealogies.
Prototype Genealogies Conclusion DELETE A conclusion (name, gender, fact) in FamilySearch genealogies.
Prototype Genealogies Agent GET A contributor to FamilySearch genealogies.
Prototype Genealogies Note GET A note in FamilySearch genealogies.
Prototype Genealogies Person Merge POST The merge resource for two persons in FamilySearch Genealogies.
Prototype Genealogies Person Restore POST The restore resource for a person in FamilySearch Genealogies.

Memories

Memories GET, POST The Memories resource is used to create memories such as photos, stories, or documents.
Memory HEAD, GET, POST, DELETE The Memory resource is used to read, modify and delete a memory, such as a photo, story, or document.
Memory Artifact POST The Memory Artifact resource is used to modify a memory artifact.
User Memories GET The User Memories resource is a (paged) list of all memories that have been contributed by a user.
Memory Personas GET, POST The Memory Personas resource defines the set of personas that have been identified on a memory (i.e. "tags").
Memory Persona GET, POST, DELETE The Memory Persona resource defines a persona (i.e. "tag") that has been identified on a memory.
Memory Comments GET, POST The comments users have made on a memory.
Memory Comment DELETE A comment a user has made on a memory.

Ordinances

Deprecated Ordinance Reservation API To obtain a copy of the complete Ordinance Reservation Service APIs, contact devsupport@familysearch.org.
Temple Names and Alpha Codes The current list of temple names and alpha codes.

Parents and Children

Relationships POST The relationships resource provides a way to create relationships.
Child-and-Parents Relationship HEAD, GET, POST, DELETE The Child-and-Parents Relationship resource manages a child-and-parents relationship.
Child-and-Parents Relationship Parent DELETE The Child-and-Parents Relationship Parent resource manages the interface for a parent in a child-and-parents relationship.
Child-and-Parents Relationship Conclusion DELETE The Child-and-Parents Relationship Conclusion resource defines the interface for deleting a specific fact attached to a child-and-parents relationship.
Child-and-Parents Relationship Change History HEAD, GET This Child-and-Parents Relationship Change History resource provides a list of changes for a child-and-parents relationship. Each entry in the change history provides details about what was changed,...
Child-and-Parents Relationship Sources Query GET The Child-and-Parents Relationship Sources Query provides a way to read all sources attached to a child-and-parents relationship in a single query.
Child-and-Parents Relationship Source References GET, POST The Child-and-Parents Relationship Source References resource defines the interface for the list of source references attached to a child-and-parents relationship.
Child-and-Parents Relationship Source Reference DELETE The Child-and-Parents Relationship Source Reference resource defines the interface for a source reference attached to a child-and-parents relationship.
Child-and-Parents Relationship Notes GET, POST This Child-and-Parents Relationship Notes resource defines the interface for a list of notes attached to a child-and-parents relationship.
Child-and-Parents Relationship Note GET, POST, DELETE This Child-and-Parents Relationship Note resource defines the interface for a note attached to a child-and-parents relationship.
Child-and-Parents Relationship Restore POST The Child-and-Parents Relationship Restore resource allows the recovery of a previously-deleted child-and-parents relationship.

Pedigree

Ancestry GET The Ancestry resource is used to query the application for an ascending pedigree rooted at a person and for a specific number of generations. The result of the query is a list of persons and...
Descendancy GET The Descendancy resource is used to query the application for a descending pedigree rooted at a person and for a specific number of generations. The result of the query provides a list of persons and...

Person

Persons POST The Persons resource provides the interface for the set of persons in the application.
Person HEAD, GET, POST, DELETE The Person resource manages a specific person and provides the interface to read, update, or delete a person. The Person resource also provides the interface to add or update specific facts attached...
Parents GET The parents of a person.
Deprecated Relationships to Parents GET The Relationships to Parents resource provides the interface for the list of parent-child relationships between a Person and that person's parents.
Spouses GET The spouses of a person.
Deprecated Relationships to Spouses GET The Person Relationships to Spouses resource provides the interface for a person's relationships to spouses.
Children GET The children of a person.
Deprecated Relationships to Children GET The Relationships to Children resource provides the interface for the list of parent-child relationships between a Person and that person's children.
Deprecated Person With Relationships GET The Person with Relationships resource is used to query for a person and all the relationships of the person. The query supports the The "person" parameter as the id for the person in the query. The...
Person Conclusion DELETE The Person Conclusion resource defines the interface for deleting a conclusion.
Deprecated Person Source References GET, POST The Person Source References resource defines a collection of source references attached to a person.
Person Source Reference DELETE The Person Source Reference resource defines the interface for a source reference.
Person Sources Query GET The Person Sources Query provides a way to read all sources attached to a person in a single query.
Person Notes GET, POST The Person Notes resource defines the interface for a list of notes attached to an entity (e.g., person, relationship). The Person Notes resource is to be considered an embedded resource, and any...
Person Note GET, POST, DELETE The Person Note resource defines the interface for a note. The Person Note resource is to be considered an embedded resource, and any links to this resource are to be treated as embedded links. This...
Deprecated Person Discussion References GET, POST The Person Discussion References resource defines a collection of discussion references attached to a person.
Person Discussion Reference DELETE A Person Discussion Reference resource defines the interface for a discussion reference.
Person Merge OPTIONS, GET, POST The Person Merge resource is used to analyze and to perform a merge between two persons.
Person Change History HEAD, GET The Person Change History resource provides a list of changes for a person. Each entry in the change history provides details about what was changed, who performed the change, and an explanation of...
Person Matches GET The Person Matches resource defines the set of matches, or possible duplicates, in the system for the specified person.
Person Not A Match List GET, POST, DELETE The Person Not A Match List defines the set of persons that are not matches for a specified person.
Person Not A Match DELETE The Person Not A Match resource is the list of person(s) declared as Not a Match for a specified person.
Person Restore POST The Person Restore action enables restoring a person that was deleted.
Preferred Spouse Relationship HEAD, GET, DELETE, PUT The Preferred Spouse Relationship resource is used to read and to update the preferred spouse relationship of a Person. The preferred spouse relationship affects only the user that creates it.
Preferred Parent Relationship HEAD, GET, DELETE, PUT The Preferred Parent Relationship resource is used to read and to update the preferred parent relationship pair for a Person in the database. The Preferred Parent Relationship affects only the user.
Current Tree Person GET The Current Tree Person resource is used to find the Person that represents the current user.
Person Memories GET, POST The Person Memories resource is a (paged) list of all memories that are linked to a person.
Person Portrait GET The Person Portrait resource is the portrait for the person.
Person Portraits GET The Person Portraits resource is the list of portraits for the person.
Deprecated Person Memory References GET, POST The Person Memory References resource defines the list of all references from a person to memories personas.
Person Memory Reference DELETE The Person Memory Reference resource defines a reference from a tree person to a memories persona.

Places

Places Search GET The Places Search resource defines an API for searching for places in the FamilySearch Place Authority.
Place Description GET The Place Description resource provides a description of a place in the FamilySearch Place Authority.
Place Descriptions Group GET The Place Descriptions Group resource provides a group of place descriptions.
Place GET The Place resource provides a place, distinct from its various descriptions.
Place Description Children GET The Place Description Children resource provides a list of "children" (jurisdictions) of a place description.
Prototype Places Feedback GET, POST The Place Feedback resource is used to submit and query feedback for the FamilySearch place authority.
Place Attributes GET The Place Attributes resource provides a list of "attributes" of a place description.
Place Type GET The Place Type resource defines a specific place type as a controlled vocabulary element.
Place Type Group GET The Place Type Group resource defines a group of related place types as a controlled vocabulary list.
Place Types GET The Place Types resource provides a list of all place types as a controlled vocabulary list.
Place Type Groups GET The Place Type Groups resource provides a list of all place type groups as a controlled vocabulary list.

Records

No resources are available.

Search and Match

Person Search GET The Person Search resource defines the interface for performing a search for persons in the tree. Each entry in the search results MAY contain content of the GEDCOM X media type that provides data...
Person Matches Query GET The Person Matches Query resource defines the interface for retrieving a list of possible matches for a person that is not already in the tree. This is particularly useful for matching a person in an...
Person Matches GET, POST The Person Matches resource defines the set of matches, or possible duplicates, in the system for the specified person.
Person Not A Match List GET, POST, DELETE The Person Not A Match List defines the set of persons that are not matches for a specified person.
Person Not A Match DELETE The Person Not A Match resource is the list of person(s) declared as Not a Match for a specified person.

Sources

Source Descriptions POST The Source Descriptions resource adds a source description to the contributor's set of source descriptions. The FamilySearch implementation of the Source Description resource does not support all...
User Source Descriptions GET, DELETE The User Source Descriptions resource is a (paged) list of all source descriptions provided by a specific user.
Source Description HEAD, GET, POST, DELETE The Source Description resource gets/updates/deletes a user's source description. The FamilySearch implementation of the Source Description resource does not support all properties of a source...
Source Folders POST The Source Folders resource is a set of all source folders in the system. This resource is used to create new source folders.
User Source Folders GET The User Source Folders resource is a list of all source folders provided by a user.
Source Folder GET, POST, DELETE The Source Folder resource defines an interface for a source folder.
Source Folder Source Descriptions GET, POST The Source Folder Source Descriptions resource is a (paged) list of source descriptions in a source folder.
Source References Query GET The Source References Query returns a set of all persons and relationships that reference a source description.

Spouses

Relationships POST The relationships resource provides a way to create a relationships.
Couple Relationship HEAD, GET, POST, DELETE The Couple Relationship resource manages a specific couple relationship and provides the interface to read, update, and delete a couple relationship. The Couple Relationship also provides the...
Couple Relationship Conclusion DELETE The Couple Relationship Conclusion resource defines the interface for deleting a conclusion.
Couple Relationship Change History HEAD, GET The Couple Relationship Change History resource provides a list of changes for a couple relationship. Each entry in the change history provides details about what was changed, who performed the...
Couple Relationship Sources Query GET The Couple Relationship Sources Query provides a way to read all sources attached to a person in a single query.
Couple Relationship Source References GET, POST The Couple Relationship Source References resource defines a collection of source references attached to a couple relationship.
Couple Relationship Source Reference DELETE The Couple Relationship Source Reference resource defines the interface for a source reference.
Couple Relationship Notes GET, POST The Couple Relationship Notes resource defines the interface for a list of notes attached to an entity (e.g., person, relationship). It is to be considered an...
Couple Relationship Note GET, POST, DELETE The Couple Relationship Note resource defines the interface for a note. It is to be considered an embedded resource, and any links to this resource are to be...
Couple Relationship Restore POST The Couple Relationship Restore resource allows a restore to a previous state, i.e., a recovery to a resource that was previously deleted.

User

Current User GET The Current User resource is used to query the application to retrieve the profile of the current user.
Current Tree Person GET The Current Tree Person resource is used to find the Person that represents the current user.
Agent GET The Agent resource defines the interface for an agent, such as a user, a system, or an organization.
User History GET, POST The Current User History resource manages a list of resources accessed by the current user.
User History Entry DELETE The Current User History Entry resource provides a way to delete an entry from the current user history.

Utilities

Pending Modifications GET The Pending Modifications resource describes the set of pending modifications that have been defined for the FamilySearch API.
Redirect GET The Redirect resource allows you to redirect a user to a FamilySearch web page, bypassing the login screen.
Prototype Metadata GET The FamilySearch Metadata Lookup.

Vocabularies

Prototype Vocabulary List GET A list of controlled vocabulary elements.
Prototype Vocabulary Term GET A specific controlled vocabulary term.