Skip to navigation

List the Investors in a Funding Round

View as Markdown

Lists the organizations and people that invested in a funding round, with the amountInvested recorded for each. Each row names its investor with investorName and investorSlug beside the investor ids and leadInvestor, so one read lists a round’s named investors; GET /v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId} returns the same rows on the round. Public reads omit joins whose investor profile is hidden, and the round’s investorCount is source-reported, so it can exceed the joins listed here. amountInvested is a plain decimal number in the fundraise transaction currency. Send a JSON number such as 220000 or 123456.78. Do not send currency signs, currency codes, comma grouping, quoted numeric strings, or abbreviations such as 220k or 0.22M. PATCH with amountInvested:null clears the value. Use entityId for the fundraising/portfolio company that raised the round — always a company, never the fund or investment firm that supplied the capital. For an Investment Firm’s outgoing investment, pass the portfolio company that received the money here and identify the firm with investorEntityId or investorEntitySlug. Use transactionId for the round id, or round plus dateAnnounced when transactionId is unknown. To list one investor’s joins, find its entityId or personId by name with POST /v1/lookup with kind ENTITY or PERSON in the JSON body (CLI lookup —kind ENTITY or —kind PERSON —name “<name>” —data) and pass it as investorEntityId or investorPersonId.

Authentication

AuthorizationBearer

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

Path parameters

entityIdstringRequiredformat: "uuid"

Entity unique identifier (UUID).

Query parameters

joinIdstringOptionalformat: "uuid"
Join identifier. When present, lookup ignores transaction and investor query parameters.
transactionIdstringOptionalformat: "uuid"

Fundraise round transaction id. The target entity id/slug is the entity that raised the round; for an Investment Firm investment, use the portfolio/fundraising company as target and identify the firm with investorEntityId or investorEntitySlug. When omitted, lookup uses the target entity plus round/dateAnnounced.

roundstringOptional
Raw fundraise round label used when transactionId is omitted
dateAnnouncedstringOptionalformat: "^(?!0000)[0-9]{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12][0-9]|3[01])(?:T(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9](?:\.[0-9]{1,9})?)?(?:Z|[+-](?:(?:0[0-9]|1[0-7]):[0-5][0-9]|18:00)))?)?)?$"

Exact source-stated announced date or instant used to disambiguate same-label rounds

investorEntityIdstringOptionalformat: "uuid"

Investor entity identifier. Find an investor’s entityId by name with POST /v1/lookup with kind ENTITY in the JSON body (CLI lookup —kind ENTITY —name “<name>” —data).

investorEntitySlugstringOptional

Investor entity slug when investorEntityId is omitted. Find it by name with POST /v1/lookup with kind ENTITY in the JSON body (CLI lookup —kind ENTITY —name “<name>” —data).

investorPersonIdstringOptionalformat: "uuid"

Investor person identifier. Find an investor’s personId by name with POST /v1/lookup with kind PERSON in the JSON body (CLI lookup —kind PERSON —name “<name>” —data).

investorPersonSlugstringOptional

Investor person slug when investorPersonId is omitted. Find it by name with POST /v1/lookup with kind PERSON in the JSON body (CLI lookup —kind PERSON —name “<name>” —data).

pageintegerOptionalDefaults to 0

Zero-based page index (0..N)

sizeintegerOptionalDefaults to 20
The size of the page to be returned

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