---
title: "Read Genealogies Person Matches"
method: GET
path: "/genealogies/persons/{pid}/matches"
tags: ["Matches"]
---

# Read Genealogies Person Matches

`GET /genealogies/persons/{pid}/matches`

The Person Matches by Genealogies Person Id resource defines the set of matches in the system for a person in the user-submitted genealogies.

The scope of the match results can be limited to a specific collection by using the `collection` query parameter.

**Use of the this resource in a production environment is restricted to applications that have been certified. Hinting applications must be certified. See [Record Hinting Certification](https://familysearch.org/developers/docs/certification/read#certreq-RR01-tree-person-recordhint).**

Currently, only the following collections support match results:

| title | identifier | description |
| --- | --- | --- |
| FamilySearch Records | `https://familysearch.org/platform/collections/records` (or just "records") | The set of FamilySearch records. |

If no collection is specified, the "records" collection will be assumed.

## Path parameters

- `pid` string, required

## Query parameters

- `collection` string
- `confidence` string
- `count` string
- `status` string

## Headers

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

## Response `200`

The read was successful. See <a href="https://developers.familysearch.org/main/docs/json-schema#person" target="_blank">Person Schema (JSON)</a>

## Other responses

- `204` — Upon a successful query with no results.
- `301` — If the genealogies person has been merged.
- `404` — If the genealogies person was not found.
- `410` — If the genealogies person has been deleted.
- `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)