Return filter metadata scoped by current filters. 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.
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.
employeeCountRangelist of objectsOptional
Inclusive reported employee-count ranges, in employees.
entityIdlist of stringsOptional
Restrict results to specific entity IDs.
entityNamelist of stringsOptional
Exact normalized match against entity brand or legal 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.
letterstring or nullOptional
First letter of the display name.
locationlist of stringsOptional
Geographic classification values.
logoOptionobjectOptional
Logo sort priority.
mainProductlist of stringsOptional
Main product classification values.
operatingStatuslist of stringsOptional
Operating status values.
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
Named server-owned list quality gate.
semanticQuerystring or nullOptional
Semantic entity search phrase.
sluglist of stringsOptional
Restrict results to entity slugs.
stagelist of stringsOptional
Investment stage classification values.
suppressNonOperatingboolean or nullOptional
Suppress entities with terminal operating status.
suppressZeroTotalRaisedboolean or nullOptional
Suppress entities whose total raised is zero.
taglist of stringsOptional
General classification tag values.
textSearchstring or nullOptional
Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.
typeCustomerlist of stringsOptional
Customer-type classification values.
typeModellist of stringsOptional
Business-model classification values.
typeOwnershiplist of stringsOptional
Ownership-model classification values.
typeRecordlist of enumsOptional
Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type.
typeRevenuelist of stringsOptional
Revenue-model classification values.
typeTechnologyUsedlist of stringsOptional
Technology-used classification values.
urlstring or nullOptional
Current URL to match by normalized host and path.
urlDomainstring or nullOptional
Current root domain to match when urlMatchMode=domain.
urlMatchModeenumOptional
URL matching mode: hostPath uses host and path; domain uses the root domain.
urlTypeenum or nullOptional
Restrict URL matching to one URL type.
yearFoundedRangelist of objectsOptional
Inclusive founding-year ranges, in calendar years.
Response
OK
filterlist of objects
Canonical filter entries for the active entity scope.
metaobject
Pagination and degradation state for this refinement.
