Example Requests

Authentication

Delete Access Token How to invalidate an access token.
Initiate Authorization (GET) How to initiate the process for obtaining an OAuth 2 authorization code with HTTP GET.
Initiate Authorization (Invalid Parameter) Example illustrating the result of invalid parameters when initiating the process for obtaining an OAuth 2 authorization code.
Initiate Authorization (POST) How to initiate the process for obtaining an OAuth 2 authorization code with HTTP POST.
Obtain Access Token (Bad Parameters) Example of invalid parameters when exchanging the authorization code for an access token.
Obtain Access Token with Authorization Code How to exchange an authorization code for an access token.
Obtain Access Token with Username and Password How to exchange a user's username and password for an access token.
Obtain Access Token without Authenticating How to obtain an access token without authenticating.

Authorities

Read Date Convert a date to GedcomX format.

Change History

Read Person Change History How to get a change history.
Read Person Change History First Page How to read the first page of a change history for a person.
Read Child-and-Parents Relationship Change History How to get the change history for a child-and-parents relationship.
Read Couple Relationship Change History How to get the change history for the relationship.
Restore Change Action How to restore a change from the change history.

Discovery

Read Discussions Collection How to read the FamilySearch Discussions collection resource.
Read Controlled Vocabulary How to read a FamilySearch Controlled Vocabulary resource.
Read Date Authority How to read the FamilySearch Date Authority resource.
Read Discovery How to read the discovery resource.
Read Family Tree Collection How to read the FamilySearch Family Tree collection resource.
Read FamilySearch Collections How to read the list of all collections described by the FamilySearch API.
Read FamilySearch Historical Records Archive How to read the collection describing the FamilySearch Historical Records Archive.
Read Memories Collection How to read the FamilySearch Memories collection resource.
Read Place Authority How to read the FamilySearch Place Authority resource.
Read Root Collection How to read the FamilySearch root collection resource.
Read User-Defined Sources Collection How to read the FamilySearch User-Defined Sources collection resource.

Discussions

Create Discussion How to create a discussion.
Create Comment How to add a comment to a discussion.
Read Discussion How to read a discussion.
Read Comments How to read the comments of a discussion.
Update Discussion How to update a discussion.
Update Comment How to update a comment.
Delete Discussion How to delete a discussion.
Delete Comment How to delete a comment.

Memories

Create Memories Comment How to create a comment on a memory.
Create Memory Persona How to create a persona on a memory.
Create User-Uploaded Source How to create a source for an artifact that a user has uploaded.
Read Memories Comments How to read the comments of users on a memory.
Read Memories for a User How to query for all memories for a user.
Read Memory How to read a memory.
Read Memory Persona How to read a memory persona.
Read Memory Personas How to read the personas of a memory.
Update Memory Persona How to update a memory persona.
Update Memory Description How to update a description of a memory.
Delete Memories Comment How to delete a comment on a memory.
Delete Memory How to delete a memory.
Delete Memory Persona How to delete a memory persona.
Upload Image as a Document How to upload an image as a document.
Upload Multiple Photo Memories How to upload multiple photo memories using a multipart request.
Upload PDF Document How to upload a PDF document.
Upload Photo How to upload a photo.
Upload Photo Via Multipart Form Data How to upload a photo via multipart form data.
Upload Story How to upload a story.
Upload Story Memories How to upload multiple stories using a multipart request.

Ordinances

Read Ordinance Policy How to read the current policy regarding LDS temple ordinances in English.
Read Ordinance Policy in French How to read the current policy regarding LDS temple ordinances in French.
Read Ordinances How to read the collection of LDS ordinance information. If the current user doesn't have permission to access the LDS ordinance information, a 403 Forbidden error will be returned.
Read Ordinances (Access Forbidden) How to determine whether the current credentials do not allow access to LDS ordinances.

Parents and Children

Create Child-and-Parents Relationship How to create a child-and-parents relationship.
Create Child-and-Parents Relationship Source Reference How to create a source reference for a child-and-parents relationship.
Create Child-and-Parents Relationship Conclusion How to add a fact on a child-and-parents relationship.
Create Child-and-Parents Relationship Note How to create a note on a child-and-parents relationship.
Create Couple Relationship How to create a couple resource.
Read Child-and-Parents Relationship How to get a child-and-parents relationship.
Read Child-and-Parents Relationship Source References How to get a list of source reference resources for a child-and-parents relationship.
Read Child-and-Parents Relationship Sources How to query for the list of sources on a child-and-parents relationship.
Read Child-and-Parents Relationship Note How to read a note on a child-and-parents relationship.
Read Child-and-Parents Relationship Notes How to get list of notes on a child-and-parents relationship.
Update Child-and-Parents Relationship How to update a child-and-parents relationship.
Update Child-and-Parents Relationship Conclusion How to update a fact on a child-and-parents relationship.
Update Child-and-Parents Relationship Note How to update a note on a child-and-parents relationship.
Delete Child-and-Parents Relationship How to delete a child-and-parents relationship.
Delete Child-and-Parents Relationship Source Reference How to delete a source reference on a child-and-parents relationship.
Delete Child-and-Parents Relationship Conclusion How to delete a fact on a child-and-parents relationship.
Delete Child-and-Parents Relationship Note How to delete a note on a child-and-parents relationship.
Delete Child-and-Parents Relationship Parent How to remove a parent from a child-and-parents relationship.
Restore Child-and-Parents Relationship How to un-delete or restore a child-and-parents relationship that has been deleted.

Pedigree

Read Person Ancestry How to read the ancestry graph for a person.
Read Person Ancestry and additional person details How to read the ancestry for a person and return additional person details.
Read Person Ancestry with Specified Spouse How to read the ancestry graph for a person with a specified spouse.
Read Person Ancestry with Specified Spouse and additional person and marriage details How to read the ancestry graph for a person with a specified spouse and return additional person details and marriage details.
Read Person Descendancy How to get the descendancy for a person.
Read Person Descendancy and additional person and marriage details How to get the descendancy for a person and return additional person details and marriage details.
Read Person Descendancy with Specified Spouse How to get the descendancy for a person with a specified spouse.
Read Person Descendancy with Specified Spouse and additional person and marriage details How to get the descendancy for a person with a specified spouse and return additional person details and marriage details.

Person

Create Person How to create a person.
Create Person Source Reference How to create a source reference on a person.
Create Person Conclusion How to create a conclusion.
Create Person Life Sketch How to create a life sketch for a person.
Create Person Memory Reference How to create a reference from a tree person to a memory persona.
Create Discussion Reference How to attach a discussion to a person.
Create Note How to create a note on a person.
Read Merged Person Example illustrating what happens during a read of a person that has been merged.
Read Deleted Person Example illustrating what happens during a read of person that has been deleted.
Read Person How to read a person.
Read Person Merge Analysis How to read an analysis for a merge of two persons.
Read Person Merge Constraint (Can Merge Any Order) How to read the constraints for a merge between two persons that can be merged in either order.
Read Person Merge Constraint (Can Merge Other Order Only) How to read the constraints for a merge between two persons that can be merged only in the other order.
Read Person Source References How to read the list of source references on a person.
Read Person Sources How to query for the list of sources on a person.
Read Person Change Summary How to get the change summary for a person.
Read Person Memories How to read all the memories linked to a person.
Read Person Memories By Type. How to read the memories linked to a person for a particular set of artifact types.
Read Person Memory References How to get the list of references from a tree person to memory personas.
Read Person Portrait How to read a portrait for a person.
Read Person Portrait With Default How to read a portrait for a person with a default image.
Read Person Portraits How to read the portraits linked to a person.
Read Person With Relationships How to query for a person and the person's relationships.
Read Relationships to Children How to read the list of relationships to the children of a person.
Read Relationships to Parents How to read the list of relationships to the parents of a person.
Read Relationships To Spouses How to read the list of relationships to the spouses of a person.
Read Relationships To Spouses with Persons How to query for the list of relationships to the spouses of a person, including the spouses.
Read Discussion References How to get list of discussions attached to a person.
Read Children of a Person How to read the list of children of a person.
Read Current Tree Person How to query for the tree person that represents the current user.
Read Current Tree Person Expecting 200 Response How to query for the tree person that represents the current user and specify that you expect a 200 response code instead of a 303 response code.
Read Not Found Person Example illustrating what happens during a read of a person that doesn't exist.
Read Not-Modified Person How to conditionally read a person that hasn't been modified.
Read Note How to read a note on a person.
Read Notes How to read the list of notes on a person.
Read Parents of a Person How to read the list of parents of a person, including any couple relationships of the parents.
Read Preferred Parent Relationship How to read a user's preferred parent relationship for a person.
Read Preferred Spouse Relationship How to read a user's preferred spouse relationship for a person.
Read Spouses of a Person How to read the spouses of a person.
Merge Person How to merge two persons.
Head Person How to read the headers for a person.
Update Person Source Reference How to update a source reference on a person.
Update Person Conclusion How to update a conclusion resource.
Update Person Custom Non-Event Fact How to update a custom fact that is designated as "not an event" in the Family Tree.
Update Person Life Sketch How to create a life sketch for a person.
Update Person Not-a-Match Declarations How to designate persons as not a match for a specific person.
Update Person With Preconditions How to do a conditional update of a person.
Update Note How to update a note.
Update Preferred Parent Relationship How to set a user's preferred parent relationship for a person.
Update Preferred Spouse Relationship How to set a user's preferred spouse relationship for a person.
Delete Person How to delete a person.
Delete Person Source Reference How to delete a source reference.
Delete Person Conclusion How to delete a conclusion resource.
Delete Person Memory Reference How to delete a reference from a tree person to a memory persona.
Delete Person Not-a-Match How to remove a person from the not-a-match list for a specific person.
Delete Person With Preconditions How to do a conditional delete of a person.
Delete Discussion Reference How to delete a discussion resource.
Delete Note How to delete a note.
Delete Preferred Parent Relationship How to delete a user's preferred parent relationship for a person.
Delete Preferred Spouse Relationship How to delete a user's preferred spouse relationship for a person.
Restore Person How to un-delete or restore a person resource that has been deleted.
Upload Photo for Person How to upload a photo for a FamilyTree person.

Places

Read Place How to get a place.
Read Place Description How to get a place description.
Read Place Description Children How to get the children of a place description.
Read Place Group How to read a place group.
Read Place Type How to get a place type.
Read Place Type Group How to get a place type group.
Read Place Type Groups How to get the list of place type groups.
Read Place Types How to get the list of place types.
Search For Places How to search for a place.
Search For Places Directly Under a Jurisdiction How to search for a place, requiring results to be limited to those <i>directly</i> under a specific jurisdiction.
Search For Places Under a Jurisdiction How to search for a place, requiring results to be limited to those directly or indirectly under a specific jurisdiction.

Records

No example requests have been provided.

Search and Match

Read Person Not-A-Match Declarations How to read the persons that have been designated as not a match for a specific person.
Read Person Possible Duplicates How to get the possible duplicates for a person.
Read Person Record Matches How to get the record matches for a person.
Read All Match Status Types Person Record Matches How to get all types of match statuses for record matches of a person.
Read Higher Confidence Person Accepted Record Matches How to get higher confidence accepted record matches for a person.
Read Match Scores for Persons How to determine the match scores for a given set of persons.
Read Next Page of Search Results How to get the first two entries of the next page of search results.
Update Match Status for Person Record Matches How to designate a match status for record matches of a person.
Search Persons How to search for persons.
Search Persons With Warnings and Errors Example illustrating what happens when there are warnings and errors during a person search.
Search For Person Matches How to search for matches of a person.

Sources

Create Source Description How to create a source description.
Create Source Folder How to create a source folder.
Create User-Uploaded Source How to create a source for an artifact that a user has uploaded.
Read Source Description How to read a source description.
Read Source Folder How to read a source folder.
Read Source References How to query for the source references that refer to a given source.
Read A Page of the Sources in a Folder How to read a page of sources in folder.
Read User Source Descriptions How to read all source descriptions provided by a specific user.
Read User Source Folders How to read the list of a user's source folders.
Update Source Description How to update a source description.
Update Source Folder How to update a source folder.
Delete Source Description How to delete a source description.
Delete Source Descriptions from a Folder How to remove source descriptions from a folder.
Delete Source Folder How to delete a source folder.
Move Sources to a Folder How to move source descriptions to a folder.

Spouses

Create Child-and-Parents Relationship How to create a child-and-parents relationship.
Create Couple Relationship How to create a couple resource.
Create Couple Relationship Source Reference How to create a source reference resource.
Create Couple Relationship Conclusion How to add a conclusion to a couple relationship.
Create Couple Relationship Note How to create a note on a relationship.
Read Couple Relationship How to get a couple resource.
Read Couple Relationship (Conditional) Example illustrating how the caching mechanism works on the couple using the ETag header.
Read Couple Relationship Source References How to get a list of source reference resources.
Read Couple Relationship Sources How to query for the list of sources on a couple relationship.
Read Couple Relationship Note How to read a note on a couple relationship.
Read Couple Relationship Notes How to get a list of notes on a couple relationship.
Read Non-Existent Couple Relationship Example illustrating a request for a couple that doesn't exist.
Head Couple Relationship How to get the couple resource headers.
Update Persons of a Couple Relationship How to update the persons that are associated by a couple relationship.
Update Couple Relationship Conclusion How to update a conclusion on a couple relationship.
Update Couple Relationship Note How to read a note on a couple relationship.
Update Illegal Couple Relationship Update the persons that are associated by a couple relationship, triggering the gender constraint.
Delete Couple Relationship How to delete a couple resource.
Delete Couple Relationship Source Reference How to delete a source reference resource.
Delete Couple Relationship Conclusion How to delete a conclusion on a couple relationship.
Delete Couple Relationship Note How to read a note on a couple relationship.
Restore Couple Relationship How to un-delete or restore a couple relationship that has been deleted.

User

Read Current Tree Person How to query for the tree person that represents the current user.
Read Current Tree Person Expecting 200 Response How to query for the tree person that represents the current user and specify that you expect a 200 response code instead of a 303 response code.
Read Current User How to query for the current user.
Read Current User's History How to query for the current user's history.
Read User How to read a contributor.
Update Current User's History How to update the current user's history.

Utilities

Read Person With Multiple Pending Modifications Activated How to read a person with multiple pending modifications activated.
Read Person With Pending Modification Activated How to read a person with a pending modification activated.
Read OEmbed Metadata How to read OEmbed metadata about a FamilySearch resource.
Redirect to Person How to redirect to a person on familysearch.org using known authentication.
Redirect to Person memories How to redirect to a person's memories on familysearch.org using known authentication.
Redirect to Source Linker How to redirect to the attach historical records page for a person on familysearch.org using known authentication.
Redirect to Uri How to redirect to a Url on familysearch.org using known authentication.

Vocabularies

Read Vocabulary List How to get vocabulary list.
Read Vocabulary Term How to get a vocabulary term.
Read Vocabulary Term, Alternate Language How to get a vocabulary term in a different language.