Resources

Authentication

OAuth 2 Guide OAuth 2 is used for authentication.
Access Token POST, DELETE The access token resource is used to obtain an access token. It can also be used to delete or invalidate an access token.
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

Authorities Properties GET Get a list of name/value pairs that pertain to the Authorities module.
Place Authority GET Get representations of authoritative place information from FamilySearch.
Name Authority GET Get representations of authoritative name information from FamilySearch.
Date Authority GET Interpret dates using FamilySearch.
Culture Authority GET Get a list of and lookup cultures used by the other FamilySearch Authorities services.

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 action enables a use 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...

Discovery

Discovery GET The Discovery resource is the index of all available resources in the application and the starting point for a Web service API. The Discovery resource allows a consumer of the API to use links to...
Prototype Root Collection GET The Root Collection resource is the description the collection that contains all FamilySearch data.
Prototype FamilySearch Collections GET The FamilySearch Collections resource is the list of all collections available at FamilySearch.org.
Prototype FamilySearch Family Tree GET The FamilySearch Family Tree resource is the describes the FamilySearch Family Tree as a collection.
Prototype FamilySearch Discussions GET The FamilySearch Discussions resource describes as a collection the set of all discussions about FamilySearch resources.
Prototype FamilySearch Memories GET The FamilySearch Memories resource describes as a collection the set of all memories provided by users to FamilySearch.
Prototype FamilySearch User-Defined Sources GET The FamilySearch User-Defined Sources resource describes as a collection the set of all sources defined by FamilySearch users.
Prototype FamilySearch Place Authority GET The FamilySearch Place Authority is the collection of all descriptions of places maintained by FamilySearch.
Prototype FamilySearch Records GET The FamilySearch Records resource describes the FamilySearch Historical Records Archive as a collection.

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.
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.

Memories

Beta Memories POST The Memories resource is used to create memories such as photos, stories, or documents.
Beta Memory HEAD, GET, POST, DELETE The Memory resource is used to read, modify and delete a memory, such as a photo, story, or document.
Beta Memory Personas GET, POST The Memory Personas resource defines the set of personas that have been identified on a memory.
Beta Memory Persona GET, POST, DELETE The Memory Persona resource defines a persona that has been identified on a memory.
Beta Memory Artifact Reference DELETE The Memory Artifact Reference resource defines the a reference from a persona to an artifact.
Beta User Memories Query GET The User Memories Query is a (paged) list of all memories that have been contributed by a user.
Beta Person Memory References GET, POST The Person Memory References resource defines the list of all references from a tree person to memories personas.
Beta Person Memory Reference DELETE The Person Memory Reference resource defines a reference from a tree person to a memories persona.
Beta Memory Comments GET, POST The comments users have made on a memory.
Beta Memory Comment DELETE A comment a user has made on a memory.

Notes

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...
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). The Couple Relationship Notes resource is to be considered an...
Couple Relationship Note GET, POST, DELETE The Couple Relationship Note resource defines the interface for a note. The Couple Relationship Note resource is to be considered an embedded resource, and any links to this resource are to be...
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.

Ordinances

Ordinance Access GET The Ordinance Access resource is used to determine whether the current user has access to LDS ordinances.
Ordinance Policy GET The Ordinance Policy resource is used to obtain the LDS ordinance policy to be displayed before submitting names for ordinance work.

Parents and Children

Relationships POST The relationships resource provides a way to create a relationships.
Child-and-Parents Relationship HEAD, GET, POST, DELETE The Child-and-Parents Relationship resource manages a child-and-parents relationship.
Parent-Child Relationship HEAD, GET, POST, DELETE The Parent-Child Relationship resource manages a relationship from a specific parent to a specific child. The parent-child relationship carries, for example, lineage-type information.
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 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 query 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 query 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.
Spouses GET The spouses of a person.
Children GET The children of a person.
Beta Person Memories Query GET The Person Memories Query is a (paged) list of all memories that are linked to a person.
Beta Person Portrait GET The Person Portrait resource is the portrait for the person.
Beta Person Portraits GET The Person Portraits resource is the list of portraits for the person.
Relationships to Spouses GET The Person Relationships to Spouses resource provides the interface for a person's relationships to spouses.
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.
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.
Person With Relationships GET The "person with relationships" query 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.
Person Merge OPTIONS, GET, POST The Person Merge resource is used to analyze and to perform a merge between two persons.
Person Change Summary GET The Person Change Summary resource provides a list of changes that apply to a person over the last 30 days. The list also includes changes to any sources and discussions that are referenced by the...
Person Not A Match GET, DELETE, POST The Person Not A Match resource is the list of person(s) declared as Not a Match for a specified person.
Restore Person POST The Restore Person 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...
Deprecated Relationships to Children (Child-and-Parents) GET The Child-and-Parents Relationship to Children resource provides the interface for the list of child-and-parents relationships from a Person to that person's children.
Deprecated Relationships to Parents (Child-and-Parents) GET The Child-and-Parents Relationships to Parents resource provides the interface for the list of child-and-parents relationships from a Person to that person's parents.

Places

Prototype Places Search GET The Places Search resource defines an API for searching for places in the FamilySearch Place Authority.
Prototype Place Description GET The Place Description resource provides a description of a place in the FamilySearch Place Authority.
Prototype Place Children GET The Place Children resource provides a list of "children" (jurisdictions) of a place.

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 GET The Person Matches resource defines the set of matches, or possible duplicates, in the system for the specified person.
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...

Source Box

User-Defined Collections for a User GET The User-Defined Collections for a User resource is a list of all user-defined collections defined by a specific user.
User-Defined Collections POST The User-Defined Collections resource is a set of all user-defined collections in the system. This resource is used to create new user-defined collections.
User-Defined Collection GET, POST, DELETE The User-Defined Collection resource is a collection defined by a user.
User-Defined Collection Source Descriptions GET, POST The User-Defined Collection Source Descriptions resource is a (paged) list of source descriptions in a user-defined collection.
User-Defined Collections Source Descriptions for a User GET, DELETE The User-Defined Collections Source Descriptions for a User resource is a (paged) list of all source descriptions in all user-defined collections defined by a specific user.

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...
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...
Person Sources Query GET The Person Sources Query provides a way to read all sources attached to a person in a single query.
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.
Prototype 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.
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.
Source References Query GET The Source References Query returns a collection of persons and relationships that has a source reference pointing to the specified 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.
Restore Couple Relationship POST The Restore Couple Relationship action 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 query is used to query the application to retrieve the profile of the current user.
Current User Person GET The Current User Person query is used to query the application to retrieve 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.

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.