---
title: "Read Preferred Spouse Relationship"
method: GET
path: "/tree/users/{uid}/preferred-spouse-relationships/{pid}"
tags: ["Relationships: Couple"]
---

# Read Preferred Spouse Relationship

`GET /tree/users/{uid}/preferred-spouse-relationships/{pid}`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/tree/users/{uid}/preferred-spouse-relationships/{pid}`
- Auth: HTTP bearer

Read the preferred spouse relationship for the given user and tree person. The preferred spouse relationship affects only the user that creates it.

## Path parameters

- `uid` string, required
- `pid` string, required

## Response `204`

No preference specified.

## Other responses

- `301`: The person has been merged into another person.
- `303`: Read was successful. Redirect to the preferred spouse relationship URI is in the 'Location' header.
- `404`: The person was not found.
- `410`: The 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)