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

# Read Persons List

`GET /tree/persons`

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.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)