Get person detail

View as Markdown

Returns person detail by id, slug, strict URL, or bounded name/domain candidate signals. Default reads hide hidden or off-sitemap people; privileged callers can use includePrivate=true for write readback. Handles canonical redirects. Every non-resolving outcome is documented on this operation’s error responses.

Authentication

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Query parameters

idstringOptionalformat: "uuid"

Group A — exact person UUID. Mutually exclusive with slug, url, and every candidate signal in group C.

slugstringOptional

Group A — exact person slug (URL-friendly identifier). Mutually exclusive with id, url, and every candidate signal in group C.

urlstringOptional

Group B — current person URL to resolve via strict host+path or domain-only match. Mutually exclusive with id and slug; may be combined with group-C candidate signals for URL-first fallback.

urlTypestringOptional

Optional URL type qualifier for URL lookup (e.g., ‘linkedin’, ‘twitter’). Narrows Group B (url) and Group C (urlDomain) matching. Not an identifier on its own.

urlMatchModestringOptional

URL match mode qualifier: ‘hostPath’ (strict host + path match, default) or ‘domain’ (host-only match). Not an identifier on its own.

nameFullstringOptional

Group C — candidate lookup signal: person full name. Combine with other group-C signals (nameAny, location, urlDomain) for bounded candidate search. Mutually exclusive with id and slug; may be combined with url for fallback.

nameAnystringOptional

Group C — candidate lookup signal: loose name match (any of given/family/full). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback.

locationstringOptional

Group C — candidate lookup signal: person location (city, state, country). Combine with other group-C signals for bounded search. Mutually exclusive with id and slug; may be combined with url for fallback.

urlDomainstringOptional

Group C — candidate lookup signal: person URL domain (host only, no path). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback.

includeUrlbooleanOptional

Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array.

includeAssociationbooleanOptional

Projection qualifier — include association values (default: true). Set false to omit association array.

includeAddressbooleanOptional

Projection qualifier — include address values (default: true). Set false to omit address array.

maxAssociationsintegerOptional

Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40.

permitMonogrambooleanOptional

Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response.

includePrivatebooleanOptional

Privileged admin readback scope. Includes hidden or off-sitemap people and privileged private fields. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.

Response

Person detail as canonical JSON or the same data rendered as compact text/plain.

associationlist of objects
Entity associations for this person
coreobject
Canonical person core record
enrichmentobject

Supplemental person data — addresses and URL links

investmentlist of objects
Investments associated with this person
nameAliaslist of objects
Display and search aliases for this person
articleCountinteger or nullOptional
pendingApprovalinteger or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error