Skip to navigation

Get Investor Portfolio Counts, Sectors and Recipients

View as Markdown

Returns the investor’s recorded investment counts, previously recorded exit and write-off counts, the split of investments by stage, and amounts in USD, with how many investments have a known USD amount. Use entityId for the investor, not a recipient. With portfolioOutcome, also returns fresh public-detail-visible direct and current primary managed-fund recipients: complete distinct cohort and primary-industry coverage counts plus independently paged sector and recipient evidence. Sector order is count descending then industry id; recipient order is recorded capital raised in USD descending (unknown last) then entity id. Both pages use page/size. Current acquired/public/closed status is not a dated exit, realized return/loss, failure cause or historical failure rate. Legacy stored totals may have a different snapshot and visibility. No co-investor or syndicate ranking is provided.

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

portfolioOutcomestringOptional

Select a current public recipient-status cohort, adding complete coverage counts and independent sector/recipient pages. Omit for the legacy stored aggregate. Neither acquired/public status nor recorded capital raised proves investor returns.

pageintegerOptional>=0

Zero-based page index (0..N)

sizeintegerOptional>=1
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
attributedInvestmentCountinteger

Count of participations with a USD-attributed investor-level amount — the coverage denominator behind totalAmountInvestedUsd, averageAmountInvestedUsd, largestAmountInvestedUsd, and smallestAmountInvestedUsd.

portfolioCompanyCountinteger
Distinct recorded recipients this investor has participated in, across all recipient operating statuses. Counts recipients, whereas totalInvestment counts distinct fundraise transactions.
topInvestmentStagelist of objects
totalInvestmentinteger

Recorded round participations, including acquisitions and grants; not holdings.

currentPortfolioCountintegerDeprecated

Legacy Operating-status recipient count, including public recipients; not current holdings. Use operatingRecipientCount.

totalPortfolioExitintegerDeprecated

Legacy acquired-status recipient count; not investor exits. Use acquiredRecipientCount.

totalWriteOffintegerDeprecated

Legacy closed-status recipient count; not investor write-offs. Use closedRecipientCount.

acquiredRecipientCountinteger or nullOptional

Distinct recorded recipients currently Acquired or Acquired Subsidiary; not investor exits. Null until the status breakdown has been calculated.

averageAmountInvestedUsddouble or nullOptional

Average investor-level attributed amount per participation, restricted to rounds whose transaction functional currency is USD. Null when no USD-attributed amounts exist for this investor.

closedRecipientCountinteger or nullOptional

Distinct recorded recipients currently Closed, Closed (Acquihire), or Inactive; not investor write-offs. Null until the status breakdown has been calculated.

largestAmountInvestedUsddouble or nullOptional

Largest single investor-level attributed amount, restricted to rounds whose transaction functional currency is USD. Null when no USD-attributed amounts exist for this investor.

operatingRecipientCountinteger or nullOptional

Distinct recorded recipients currently Operating, excluding the public bucket; not current holdings. Null until the status breakdown has been calculated.

portfolioobject or nullOptional

Selected fresh public recipient cohort and paged sector/recipient evidence. Null when portfolioOutcome was not requested or this capability is unavailable. Its visibility and snapshot differ from the legacy stored activity totals.

publicRecipientCountinteger or nullOptional

Distinct recorded recipients with current unconflicted Public ownership, or legacy Public status, excluding acquired/closed recipients; not exits. Unknown statuses are not inferred from funding. Null until the status breakdown has been calculated.

smallestAmountInvestedUsddouble or nullOptional

Smallest single investor-level attributed amount, restricted to rounds whose transaction functional currency is USD. Null when no USD-attributed amounts exist for this investor.

totalAmountInvestedUsddouble or nullOptional

Sum of investor-level attributed amounts (amount_invested) restricted to rounds whose transaction functional currency is USD. Null when no USD-attributed amounts exist for this investor.

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