Skip to navigation

List the Investments a Company Made

View as Markdown

Lists the investments made by the investor entity identified by entityId. Use entityId to select the investor, then filter by round, dateFrom/dateTo, minAmount/maxAmount, and latestPerEntity. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amountRaised. Valid sort syntax is sort=amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values. Deep traversal uses cursor: pass the prior X-Next-Cursor value as cursor and reuse the same filters and sort. For co-investor questions, this list alone is insufficient: GET /v1/entities/{entityId:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}/investor-activity provides investor counts and stage mix, but neither operation returns co-investor rankings or a sector-filtered syndicate analysis.

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

pageintegerOptional>=0

Zero-based page index for offset paging; omit it for the first page. Ignored when cursor is sent: to continue a cursor traversal, send the X-Next-Cursor value as cursor and leave page out.

roundstringOptional
Round label contains filter
dateFromdateOptional
Inclusive minimum announced date
dateTodateOptional
Inclusive maximum announced date
minAmountlongOptional

Inclusive minimum amount raised in USD, using each round’s USD-converted amount. Rounds with no recorded amount or no available USD conversion do not match. Use a plain whole-number amount such as 500000; do not include currency signs, codes, comma grouping, decimals, or strings.

maxAmountlongOptional

Inclusive maximum amount raised in USD, using each round’s USD-converted amount. Rounds with no recorded amount or no available USD conversion do not match. Use a plain whole-number amount such as 50000000; do not include currency signs, codes, comma grouping, decimals, or strings.

permitMonogrambooleanOptional
Permit monogram fallback
roundExactstringOptional

Funding rounds only, not outgoing investments: match the canonical participation write selector’s exact stored round label, ignoring case and surrounding spaces. Cannot combine with round, dateFrom, dateTo, minAmount or maxAmount. Returns one bounded page of at most two raw ambiguity witnesses, without display deduplication: totalElements=2 means at least two matches, not an exhaustive count. Requires page=0, size>=2 and no cursor; no stable subset or export traversal is promised across requests. Omit dateAnnounced for no date constraint.

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)))?)?)?$"

Funding rounds only; requires roundExact. ResearchDate announcement-period overlap uses the canonical participation write selector: ISO year, year-month, day or offset timestamp, preserving supplied precision. Omission imposes no date constraint. Two timestamps match only at the same instant; calendar periods overlap and timestamp/calendar comparisons use the timestamp’s UTC day.

latestPerEntitybooleanOptional
Return latest transaction per entity
cursorstringOptional

Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.

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

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Response headers

X-Next-CursorstringOptional

Opaque continuation token, present when another page exists; send it as cursor to read that page. The body’s number, first, and totalPages describe offset paging only; they do not advance while you follow cursors.

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