---
title: "Read Persons List"
method: GET
path: "/tree/persons"
tags: ["Persons"]
---

# Read Persons List

`GET /tree/persons`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/tree/persons`
- Auth: HTTP bearer

Read a list of persons. Invalid ids will be returned in Warning headers. The maximum number of persons that can be read is 200.

## Query parameters

- `pids` string

## Headers

- `Accept` 'application/x-fs-v1+json' | 'application/x-gedcomx-v1+json' | 'application/json' | 'application/x-fs-v1+xml' | 'application/x-gedcomx-v1+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

- `400`: If the request was unable to be understood by the application.
- `404`: If a requested person is not found.
- `410`: If a requested person has been deleted.
- `429`: The request was throttled.

---

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