Get One Company, Product, or Service by ID
Returns one company’s full profile by exact UUID, the read for a company brief: identity, funding history with each round’s lead investors, key people, news, and relationships. For an existing slug, profile URL, website, or domain, use GET /v1/entities/lookup-exact. For a name, use POST /v1/entities/search with entityName, verify the candidates against identity evidence, then read the confirmed id. Use universal lookup only when its possible filing effect is intended. Select stored financial facts with financialYear plus financialPeriod; otherwise they are omitted. 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
Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token
Path parameters
Query parameters
Concrete entity type qualifier; group-only Organization is invalid. List the accepted concrete tokens and their aliases with GET /v1/entities/types (CLI: entities types list).
Exact peer UUIDs in display order for an optional cited comparison on the UUID item JSON read. Exclude the subject and duplicates; subject plus peers must fit the served search answer policy maxEntityEvidence. Uses public stored evidence only, requires the caller’s paid natural-search entitlement, and consumes no search allowance or peer views. Omit for ordinary reads; ignored on HEAD and SSE.
Select stored financial facts for this exact year together with financialPeriod. Omit both for ordinary detail reads; ignored on HEAD and SSE.
Exact stored financial period token, without trimming or normalization. Supply with financialYear; must be nonblank and at most six characters. Ignored on HEAD and SSE.
Response headers
Opaque 64-hex name revision; uncached privileged reads bind ownership heads, while public and legacy revisions remain value-only.
Requests allowed per client IP in the current rate-limit window.
Requests left before the tightest applicable rate-limit bucket rejects.
Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.
Response
Entity detail as canonical JSON or the same data rendered as compact text/plain.
Entity enrichment: addresses, classification, funding summary, text, and URL links.
Fundraise rounds associated with this entity. When newsArticle or an external source reports a newer round not yet listed here, report both and ask the user whether to request a record update via POST /v1/entities/{entityId}/enrichments (CLI: entities enrichments enrich; MCP: aventure_job enrichEntity).
News articles associated with this entity; full-detail search carries the first few, and GET /v1/news?owner.entityId={entityId} lists them all. Articles whose headline names the entity (brand or alias) and were published within a recent window lead, then newest first; explicit sorts and text search on the list are unchanged. When an indexed article reports a newer funding round, role, or milestone not yet reflected in structured fields, report both and offer to request an update on the record.
People associated with this entity; full-detail search carries the first few, and GET /v1/entities/{entityId}/people lists them all.
Research findings: structured research details, written research snippets, and accelerator participation.
Public buyer of the newest completed acquisition; null for announced or non-public buyers.
Optional cited comparison of this public profile with comparisonEntityId in the requested order. Null when not requested, not entitled, withheld, or unavailable. HEAD and detail streams never compose it; ordinary detail admission is unchanged.
The queued or running full-research run covering this record; null when none, and always null on people embedded in another record.
Derived profile status; read-only.
Fund manager firm or product/service provider; null otherwise.