---
title: "Read Tree Matches"
method: GET
path: "/trees/{tid}/matches"
tags: ["Trees"]
---

# Read Tree Matches

`GET /trees/{tid}/matches`

Returns the matches for a user tree. Allows filtering on the request to focus on the “best” historical record hints, person hints to other user trees or to the Shared Family Tree.

## Path parameters

- `tid` string, required

## Query parameters

- `sortBy` string
- `from` string
- `candidateTreeId` string
- `collection` string
- `count` string
- `confidence` integer
- `status` string

## Headers

- `Accept` 'application/x-gedcomx-atom+json' | 'application/json', required

## Response `200`

Matches found

## Other responses

- `204` — No matches found
- `400` — Invalid request parameters
- `429` — The request was throttled.

---

[API](https://skmtc.net/familysearch/apis/authentication-endpoints.md) · [All operations](https://skmtc.net/familysearch/apis/authentication-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/familysearch/authentication-endpoints/revisions/2b5020574a62/schema)