Owner Claim

View owner claim details

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

curl https://api.faireplace.com/api/owner-claim/3f8b1c2d-...-9a0e

Response:

{
  "initiator_email_partial": "jo***@example.com",
  "owner_display_name": "Jean Dupont",
  "expires_at": "2026-06-27T10:00:00Z"
}
get/owner-claim/{token}

Request

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

Path parameters

tokenstring required

Owner claim token (clear value from the email link).

Response

Owner claim details retrieved.

initiator_email_partialstring required

Masked initiator email (first chars + domain), e.g. jo***@example.com.

owner_display_namestring required

Owner display name (last name, plus first name for individuals).

expires_atstring date-time required

Expiration date of the claim session.

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.