aVenture APIPeople

Get person by ID

View as Markdown
Returns person detail by exact UUID. Use lookup for a slug, URL, or candidate signals.

Authentication

X-Client-Secretstring

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

Path parameters

personIdstringRequiredformat: "uuid"
Exact person UUID.

Query parameters

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 compact text.
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
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error