Skip to navigation
aVenture APICompaniesEntity Filters

Refine the Company Filter Options

View as Markdown
Returns each entity filter's available options and counts, limited to the entities that match the filters you already applied. Each filter entry reports choiceOptionTotal and choiceOptionTruncated so CLI and MCP callers can tell when the displayed choiceOption list is only the top scoped subset. Use the filter search endpoint with the same scopeFilter to look up values not shown in the refine response.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Request

This endpoint expects an object.
acceleratorBrandlist of stringsOptional
Accelerator brand or operator name.
acceleratorCohortlist of stringsOptional
Accelerator batch or cohort label.
acceleratorNamelist of stringsOptional
Specific accelerator program name.
acceleratorStatuslist of stringsOptional
Accelerator participation status.
affinitylist of stringsOptional

Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.

closedLastbooleanOptional

Rank terminal entities (Acquired, Closed, Closed (Acquihire), Inactive) after every other textSearch or semanticQuery match, ahead of relevance and sort, except that an exact textSearch name, slug, legal-name, or alias match of any status ranks ahead of every weaker match; omitted means true. false ranks them by relevance alone. Filter them out with operatingStatus or suppressNonOperating.

employeeCountRangelist of objectsOptional

Current workforce ranges; omitted matchMode is numeric-only.

entityIdlist of stringsOptional
Restrict results to entity IDs.
entityNamelist of stringsOptional
Exact normalized match against entity brand, legal, or alias names.
featuredboolean or nullOptional
Filter by featured status.
fundraiseActivityobjectOptional
Fundraise activity
hasFundraisingboolean or nullOptional
Filter to entities with fundraise activity.
headquartersCitylist of stringsOptional
Headquarters city values.
headquartersCountrylist of stringsOptional
Headquarters country values.
headquartersStatelist of stringsOptional
Headquarters state or region values.
industrylist of stringsOptional
Industry classification values.
investorPopulationboolean or nullOptional

Opt in to Firms/Funds, a current source-stated investing mandate, or recorded non-grant direct/current-primary-managed investment participation. Omitted/false keeps legacy scope; explicit typeRecord intersects. Prose, legal form and missing funding establish nothing.

letterstring or nullOptional
First letter of the display name.
locationlist of stringsOptional
Markets served, not HQ or offices.
logoOptionobjectOptional
Logo sort priority.
mainProductlist of stringsOptional
Main product classification values.
noteworthyOnlybooleanOptional
When true, only operating companies or business lines with a real logo, founding year, and current headquarters that had notable activity in the last 48 hours.
operatingStatuslist of enumsOptional

Operating states; omit for all.

originCountrylist of stringsOptional

Countries an entity is from: its headquarters country or the country of its current origin (founding) address, never a legal seat alone. What a nationality adjective (Colombian startups) means; headquartersCountry is only where it is based now.

personlist of stringsOptional
Associated person, matched by name.
portfolioHeadquartersCitylist of stringsOptional

Portfolio-company headquarters city values.

portfolioHeadquartersCountrylist of stringsOptional

Portfolio-company headquarters country values.

portfolioHeadquartersStatelist of stringsOptional

Portfolio-company headquarters state or region values.

qualityGateenumOptional

Extra listing check: COMPANY_LISTING_READY or NONE (default, no check).

Allowed values:
rankByProminenceboolean or nullOptional

Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean.

sluglist of stringsOptional
Restrict results to entity slugs.
stagelist of stringsOptional
Stage classification values.
standardizedClassificationlist of objectsOptional

Matches any one of these entries; combined with the other filters by AND.

suppressLateStageboolean or nullOptional

Exclude public and acquired companies (including acquired subsidiaries); what startup means. Private companies at any round stay, as do companies without a recorded stage or operating status.

suppressNonOperatingboolean or nullOptional
Suppress entities with terminal operating status.
suppressZeroTotalRaisedboolean or nullOptional
Suppress entities with zero or unknown USD total raised.
taglist of stringsOptional
General classification tag values.
textSearchstring or nullOptional

Non-blank company-identity search term: it matches only brand names, legal names, slugs, and name aliases (including near spellings of them), never descriptions, products, or topics. A topic, sector, or market word such as “climate” or “corporate card” returns no rows or name lookalikes here: filter by the industry, tag, mainProduct, or other classification fields, send the phrase as semanticQuery on POST /v1/entities/search, or ask natural search for plain-English or multi-constraint company requests.

typeCustomerlist of stringsOptional

Customer-type classification values.

typeModellist of stringsOptional

Business-model values.

typeOwnershiplist of stringsOptional

Ownership-model values.

typeRecordlist of enumsOptional

Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, Government, and Business Line; omit to include every entity type.

typeRevenuelist of stringsOptional

Revenue-model classification values.

typeTechnologyUsedlist of stringsOptional

Technology-used values.

uniqueIdlist of objectsOptional

Matches any listed registry identifier; combined with other filters by AND.

urlstring or nullOptional
Current URL to match by normalized host and path.
urlDomainstring or nullOptional

Current root domain to match when urlMatchMode=domain.

urlMatchModeenum or nullOptional

URL matching mode: hostPath uses host and path; domain uses the root domain. Omitted, it is domain when urlDomain is set, else hostPath.

Allowed values:
urlTypestring or nullOptional
Restrict URL matching to one URL type.
yearFoundedRangelist of objectsOptional

Inclusive founding-year ranges.

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
filterlist of objects
Canonical filter entries for the active entity scope.
metaobject
Pagination and degradation state for this refinement.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error