Skip to navigation

List the People at a Company: Its Team, Founders, and Key People

View as Markdown

Lists who works at a company (its team): founders, executives, key people, management, employees, and other associated people, with each person’s title and whether the role is current. Use it for team members, key people, or founders at a company; a person’s name alone never resolves through an exact person lookup.

Authentication

AuthorizationBearer

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

Path parameters

entityIdstringRequiredformat: "uuid"
Entity UUID

Query parameters

searchstringOptional
Search term filter
rolestringOptional

Match titleName containing this text as a whole-word phrase, ignoring case: founder matches Co-Founder, Founder & CEO, and CEO and Co-Founder, but not Founding Partner. Omit to include all titles; this does not filter titleFunction or titleLevel.

isCurrentbooleanOptional
Current association filter
includeUrlbooleanOptional
Include person URL records
includeAddressbooleanOptional
Include person address records
personSlugstringOptional

Writes only: the person’s slug when the body omits personId. List reads ignore it; use search to narrow listed people.

countOnlybooleanOptional
Return count metadata without full content
permitMonogrambooleanOptional
Permit generated monogram fallback
pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 20
The size of the page to be returned
sortlist of stringsOptional

Sorting criteria in the format property,(asc|desc), where property is one of: id, nameFirst, nameLast, nameFull, slug, createdAt, updatedAt, status, gender, amountInvested, totalInvestments. Default order is ascending; repeat sort for multiple criteria.

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

OK
contentlist of objectsOptional
emptybooleanOptional
firstbooleanOptional
lastbooleanOptional
numberintegerOptional
numberOfElementsintegerOptional
pageableobjectOptional
sizeintegerOptional
sortobjectOptional
totalElementslongOptional
totalPagesintegerOptional

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