Skip to navigation
aVenture APIPeoplePeople

Get One Person by ID

View as Markdown

Returns person detail by exact UUID. For an existing slug or profile URL, use GET /v1/people/lookup-exact. For a name, use POST /v1/people/search with personName, verify the candidates against identity evidence, then read the confirmed id. Use universal lookup only when its possible filing effect is intended. 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.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Path parameters

personIdstringRequiredformat: "uuid"
Exact person UUID.

Query parameters

includeUrlbooleanOptional

Include URL link values in the response (default: true). Set false to omit urlLink array.

includeAssociationbooleanOptional

Include association values in the response (default: true). Set false to omit association array.

includeAddressbooleanOptional

Include address values in the response (default: true). Set false to omit address array.

maxAssociationsintegerOptional

Maximum association values to return; the server caps it at its own association limit. Default: 40.

permitMonogrambooleanOptional

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

includelist of enumsOptional

Profile panels to embed in this one read (repeat or comma-separate). Each named panel answers the same rows as its own endpoint’s first page; omitted panels stay absent.

Allowed values:

Response headers

X-RateLimit-LimitintegerOptional

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

X-RateLimit-RemainingintegerOptional

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

X-RateLimit-ResetintegerOptional

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
A person's core profile fields.
enrichmentobject

Supplemental person data — addresses and URL links

investmentlist of objects

Investments associated with this person. When include names investment, these are newest first, the same rows as GET /v1/people/{personId}/investments?sort=date,desc&size=200 page 0: fewer than 200 rows is the whole list, otherwise continue at page=1 with the same sort and size.

nameAliaslist of objects
Display and search aliases for this person
articleCountinteger or nullOptional
blogPostlist of objects or nullOptional

Newest active blog posts first; present only when include names blogPost

coveringRunIdstring or nullOptionalformat: "uuid"

The queued or running full-research run covering this record; null when none, and always null on people embedded in another record.

graphobject or nullOptional

Precomputed person graph; present only when include names graph

investorActivityobject or nullOptional

Investor activity rollup; present only when include names investorActivity

similarlist of objects or nullOptional

Most similar people, highest score first; present only when include names similar

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden 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