Get entity people association
Returns one entity-scoped association detail. Public and client-secret reads hide associations to hidden entities; trusted admin credentials can read them back.
Authentication
X-Client-Secretstring
Client secret for read-only service-to-service access (no writes)
Path parameters
entityId
Entity UUID
associationId
Association id
Query parameters
id
Entity unique identifier (UUID) — at least one of id or slug required
slug
Entity URL-friendly identifier — at least one of id or slug required
search
Search term filter
role
Association role filter
isCurrent
Current association filter
includeUrl
Include person URL records
includeAddress
Include person address records
as
Projection: `core` (default) returns person identity only and omits association fields. `association` returns PersonDetail rows with the matching join under `association[]`; read title and period fields from `association[].titleName`, `association[].startDate`, and `association[].endDate`. Person sitemap visibility is owned by people detail/status reads, not this list projection.
personSlug
Person slug fallback for entity-keyed writes
countOnly
Return count metadata without full content
permitMonogram
Permit generated monogram fallback
includePrivate
Privileged read scope. Includes associations on hidden entities. Defaults to private visibility for admin API key or ROLE_ADMIN callers; explicit true requires that authority.
Response
OK
association
Entity associations for this person
core
Canonical person core record
enrichment
Supplemental person data — addresses and URL links
investment
Investments associated with this person
nameAlias
Display and search aliases for this person
articleCount
pendingApproval
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error