---
title: "View owner claim details"
method: GET
path: "/owner-claim/{token}"
tags: ["Owner Claim"]
---

# View owner claim details

`GET /owner-claim/{token}`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/owner-claim/{token}`
- Auth: none required

Returns a minimal public summary of an owner claim so the recipient can
confirm they are looking at the right request before logging in.

## Authentication
This endpoint is **public** (the user is not yet authenticated when they
click the email link). The only credential is the claim token in the URL
path.

## Privacy
Anti-leak by design: the initiator email is masked
(`jo***@example.com`), the owner email is never returned, and no internal
IDs are exposed. Unknown / consumed tokens return a generic `404`
(anti-oracle); responses are padded to a constant minimum latency.

## Example
```bash
curl https://api.faireplace.com/api/owner-claim/3f8b1c2d-...-9a0e
```

**Response**:
```json
{
  "initiator_email_partial": "jo***@example.com",
  "owner_display_name": "Jean Dupont",
  "expires_at": "2026-06-27T10:00:00Z"
}
```

## Path parameters

- `token` string, required

## Response `200`

Owner claim details retrieved.

- OwnerClaimDetailsView: Minimal public summary shown on the confirmation screen before login. Anti-leak: the initiator email is masked, the owner email is never returned, and no internal IDs (auth_user_id, owner_id) are exposed.
  - `initiator_email_partial` string, required: Masked initiator email (first chars + domain), e.g. `jo***@example.com`.
  - `owner_display_name` string, required: Owner display name (last name, plus first name for individuals).
  - `expires_at` string, date-time, required: Expiration date of the claim session.

## Other responses

- `404`: Token invalid, not found, consumed, or malformed (generic, anti-oracle).
- `410`: The claim has expired (or been consumed).
- `500`: Internal error (no infra details leaked).

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)