aVenture APIEntities

Get one company, product, or service by id

View as Markdown
Returns entity detail by exact UUID. Use lookup for a slug, URL, or candidate signals. 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. Service-credential (client secret or admin API key) and anonymous reads are never charged.

Path parameters

entityIdstringRequiredformat: "uuid"
Exact entity UUID.

Query parameters

typeRecordstringOptional

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).

permitMonogrambooleanOptional
Allow generated monogram logo fallback.
includePrivatebooleanOptional

Includes hidden or off-sitemap entities and hidden research snippets when the caller has private-visibility authority.

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

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.

coreobject
Core entity identity, naming, status, image, and source metadata.
enrichmentobject

Entity enrichment: addresses, classification, funding summary, text, and URL links.

fundraiseRoundlist of objects
Fundraise rounds associated with this entity.
newsArticlelist of objects
News articles associated with this entity.
personlist of objects
People associated with this entity.
relationshiplist of objects
Entity relationships.
researchobject

Combined research disclosure: governed detail rows, snippets, and accelerator participation.

sitemapobject

Sub-route eligibility computed once at the persistence boundary.

uniqueIdlist of objects
External registry identifiers associated with this entity.
publicUrlstring or nullOptional
Absolute canonical public URL when this detail has a renderable public route.

Errors

400
Bad Request 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