---
title: "Read Genealogies Bulk Matches"
method: GET
path: "/genealogies/persons/{gpids}/bulkmatches"
tags: ["Matches"]
---

# Read Genealogies Bulk Matches

`GET /genealogies/persons/{gpids}/bulkmatches`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/genealogies/persons/{gpids}/bulkmatches`
- Auth: HTTP bearer

Read a set of matches for the given genealogies persons.

## Path parameters

- `gpids` string, required

## Headers

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

## Response `200`

The read was successful.

## Other responses

- `204`: Upon a successful query with no results.
- `404`: If the requested genealogies persons are not found.
- `429`: The request was throttled.

---

[API](https://skmtc.dev/familysearch/apis/genealogies-endpoints.md) - [All operations](https://skmtc.dev/familysearch/apis/genealogies-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/familysearch/apis/genealogies-endpoints/revisions/0084dedb6ce0?raw)