---
title: "Check whether two members are the same person"
method: POST
path: "/v1/members/merge-preview"
tags: ["members"]
---

# Check whether two members are the same person

`POST /v1/members/merge-preview`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/members/merge-preview`
- Auth: HTTP bearer

Judge a proposed merge and list exactly what it would move. Writes nothing.

## Headers

- `X-Tenant-Id` string, nullable

## Request body

- MemberMergePreviewBody: Which two members, and which way round.
  - `surviving_membership_id` string, uuid, required: The member who keeps their account.
  - `retiring_membership_id` string, uuid, required: The duplicate, retired by the merge.
  - `mailbox_proof_id` string, uuid, nullable: A consumed mailbox proof issued for the retiring member.

## Response `200`

Successful Response

- MemberMergePreviewResponse: What would happen, and if it may not, why not.
  - `allowed` boolean, required
  - `evidence_code` string, nullable
  - `refusal_code` string, nullable
  - `detail` object
  - `emails_gained` string[]
  - `chat_identity_moves` boolean
  - `rows_moved` integer
  - `carried` MemberMergeCarriedItem[]
    - `table` string, required
    - `column` string, required
    - `row_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)