---
title: "Read Spouses"
method: GET
path: "/tree/persons/{pid}/spouses"
tags: ["Persons"]
---

# Read Spouses

`GET /tree/persons/{pid}/spouses`

## Request

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

Read the set of spouses for a specific person.

## Path parameters

- `pid` string, required

## 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#relationship" target="_blank">CoupleRelationship Schema (JSON)</a>

## Other responses

- `204`: Upon a successful read and no relationships exist.
- `404`: If the requested resource is not found.
- `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)