---
title: "Read Person Matches by ID Headers"
method: HEAD
path: "/tree/persons/{pid}/matches"
tags: ["Matches"]
---

# Read Person Matches by ID Headers

`HEAD /tree/persons/{pid}/matches`

Determine if there are matches for the given person id.

## Path parameters

- `pid` string, required

## Query parameters

- `collection` 'tree' | 'user_trees' | 'records' | 'cet'
- `confidence` integer
- `count` integer
- `status` string
- `treeId` string

## Response `200`

The read was successful.

## Other responses

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