Read Tree Matches

The id of the tree whose matches are to be retrieved. To find user tree IDs, see <a href="/reference/getgroups" target="_blank">Read User's Groups</a>, or <a href="/reference/createtree" target="_blank">Create Tree</a> to create a new user tree.

Sort order for the matches. Accepted values are 'score' and 'recent'. Default is 'score'.

• score: returns hints by score, with highest scoring hints first.
• recent: returns hints by date, with the most recent hints first.

Page token specifying the page to be retrieved. A next link with a page token is returned in the response when there are more matches available.

Use candidateTreeId to get Person matches within a specific user tree. If present, collection=user_trees must be used. To find user tree IDs, see <a href="/reference/getgroups" target="_blank">Read User's Groups</a>, or <a href="/reference/createtree" target="_blank">Create Tree</a> to create a new user tree.

The collection specifies the category of hints to get. It specifies the system to retrieve matches from. Default is 'records'.

• tree returns person matches within the Family Tree.
• records returns historical record hints for the specified treeId.
• user_trees returns person matches within user trees.

The number of matches to return. Minimum is 1, maximum is 100. Default is 5.

The level of confidence of the results. The higher the number, the higher the confidence desired.

The status of the matches to retrieve. Default is 'pending'. Multiple status flags may be set in the same request.

• pending returns hints that have not been accepted or rejected. These are actionable hints for the specified id.
• accepted returns hints that have been accepted for the specified id.
• rejected returns hints that have been rejected for the specified id.

Specifies the media type(s) that the client is willing to accept in the response.