Read a company or person identity without scheduling enrichment
Runs the existing company and person identification ladders and returns MATCHED, NO_MATCH, or NEEDS_REVIEW within the caller’s visibility. This read never schedules background enrichment or repair. Name-identification quota and live deadlines apply.
Authentication
Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token
Query parameters
Name exactly as the source writes it, such as Acme AI or Jane Doe. Required even when url is sent; to read a record from only a URL (an aVenture page, website, or domain) use the exact read instead: entities lookup-exact get --url, or people lookup-exact get --url for a person.
URLs the subject owns: its website, its LinkedIn company or person profile, or a registry page. At most 10. Put articles in sourceUrl.
City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own.
Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing.
aVenture news id of the article that mentions the subject; an unknown id is a 400.
URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched.
Also considers hidden and unpublished records; needs private-visibility authority. Without it, NO_MATCH covers only records you can see.
Response headers
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
Other stored records judged to be this same subject stored again: likely duplicate records to merge into match. Empty when none were found.
What the caller does next: act on match, create, or ask the user.
Decision-model confidence, 0 to 1, in its pick: the candidate it named as the subject, or, when it picked none, that no candidate is. Present whenever a judgment ran, including a none pick; absent when no judgment ran. The kind-agnostic lookup reports the side whose answer it returns.
Decision-model probability, 0 to 1, that the evidence can tell the subject apart from namesakes. Absent when no judgment ran. The kind-agnostic lookup reports the side whose answer it returns.