aVenture APIPeople

Get one person by id

View as Markdown
Returns person detail by exact UUID. Use lookup for a slug, URL, or candidate signals. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Service-credential (client secret or admin API key) and anonymous reads are never charged.

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

Includes hidden or off-sitemap people and private fields when the caller has private-visibility authority.

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

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

Errors

400
Bad Request Error
404
Not Found Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error