npm - @aventurevc/aventure-cli - Versions diffs - 0.8.183 → 0.8.185 - Mend

@aventurevc/aventure-cli 0.8.183 → 0.8.185

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (46) hide show

package/dist/chunks/openapi-commands-XSw0ZcJR.js DELETED Viewed

@@ -1 +0,0 @@

- var e=`3d443fa340b44907`,t=[{operationId:`getIdentification`,method:`GET`,path:`/v1/lookup`,resource:`lookup`,intent:`read`,cliPath:[`lookup`],summary:`Read a Company, Product, Service, or Person Identity Without Enrichment`,description:`Returns what aVenture knows about a subject: MATCHED, NO_MATCH, or NEEDS_REVIEW among the records you can see, honoring the requested type and provider. To identify a subject with every lookup option, use POST /v1/lookup. Send name, url, or both; neither answers 422. A NO_MATCH subject whose own site a web search finds, and whose live page names it, is added as a new unpublished record automatically and returned in created; adding it starts no research and charges nothing. An exact id, handle, or slug answers without spending quota; past it, name-identification quota and live deadlines apply. A signed-in caller that sends Prefer: respond-async gets 202 with a Location status URL instead: a lookup job runs this same identification without the live deadline, and GET /v1/lookup-jobs/{jobId} returns it as identification once COMPLETED. A repeat of the same request returns the same job while it is still PENDING or RUNNING.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`Identification`,parameters:[{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!1,description:`Name exactly as the source writes it, such as Acme AI or Jane Doe. Send name, url, or both; a name that is an absolute http(s) URL is read as url.`,schemaType:`string`,location:`query`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`URLs the subject owns: its website, its LinkedIn company or person profile, an aVenture page, or a registry page. At most 10. Required when name is omitted. Put articles in sourceUrl.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own.`,schemaType:`string`,location:`query`},{name:`context`,optionKey:`context`,flag:`--context <context>`,required:!1,description:`Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing.`,schemaType:`string`,location:`query`},{name:`sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article that mentions the subject; an unknown id is a 400.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Entity type to identify. A Product or Service never matches its provider organization, but a record stored under a neighboring type of the same family (Product or Service; Fund, Investment Firm, or Company) still matches, and a Business Line lookup sees both families. Invalid for a person lookup. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`query`},{name:`providerId`,optionKey:`providerId`,flag:`--provider-id <uuid>`,required:!1,description:`Provider entity id for a Product or Service lookup. Omit it when the provider is unknown. With no typeRecord, searches both Product and Service. Invalid for a company type or a person lookup.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`kind`,optionKey:`kind`,flag:`--kind <kind>`,required:!1,description:`Kind of record to identify when you know it: ENTITY for companies, funds, and firms (and their products or services); PERSON for people. Only that kind is looked up; typeRecord or providerId implies ENTITY. Allowed values: ENTITY, PERSON.`,schemaType:`string`,choices:[`ENTITY`,`PERSON`],location:`query`},{name:`sourceIdentifier.idType`,optionKey:`sourceIdentifierIdType`,flag:`--source-identifier-id-type <source-identifier-id-type>`,required:!1,description:`Identifier type token, for example ein, secCik, or ticker.`,schemaType:`string`,location:`query`},{name:`sourceIdentifier.identifier`,optionKey:`sourceIdentifierIdentifier`,flag:`--source-identifier-identifier <source-identifier-identifier>`,required:!1,description:`Identifier value as issued by the registry.`,schemaType:`string`,location:`query`},{name:`sourceIdentifier.source`,optionKey:`sourceIdentifierSource`,flag:`--source-identifier-source <source-identifier-source>`,required:!1,description:`Optional attribution source label for the mapping.`,schemaType:`string`,location:`query`},{name:`Prefer`,optionKey:`prefer`,flag:`--prefer <prefer>`,required:!1,description:`Send respond-async to request a pollable lookup job; exact matches answer live.`,schemaType:`string`,location:`header`}]},{operationId:`lookupRecord`,method:`POST`,path:`/v1/lookup`,resource:`lookup`,intent:`lookup`,cliPath:[`lookup-from-file`],summary:`Identify a Company, Product, Service, or Person by Name, URL, or ID`,description:`Identifies the company, Product, Service, or person that a name, URL, or id refers to among the records you can see. Send name, at least one url, or both; neither answers 422, and a name that is a URL is read as url. Optional clues narrow the answer: kind (ENTITY or PERSON) when you know which kind the subject is, typeRecord or providerId for a Product or Service from a known provider, and context such as an employer or title. A name that is exactly a record's id, public handle, registry id (ticker, LEI, EIN), or slug answers at once. status is MATCHED, NEEDS_REVIEW, or NO_MATCH. MATCHED: match.owner names one record, by entityId (match.record.typeRecord tells a company from a Product or Service; read it with GET /v1/entities/{entityId}) or by personId (read it with GET /v1/people/{personId}). NEEDS_REVIEW: more than one record fits, such as a company and a person sharing a name; candidate lists them, and resending with a URL the subject owns or its kind usually settles it. NO_MATCH: no record you can see was confirmed as this subject; a former, alternate, or legal name may still match through the entityName filter of GET /v1/entities. A NO_MATCH subject whose own site a web search finds, and whose live page names it, is added as a new unpublished record with its name, website, and logo, and the answer returns it as created; adding it spends nothing and starts no research. To have aVenture research a subject, request research with POST /v1/research-runs and its url and name, which spends one research unit. Set scheduleEnrichment=true to also queue research on a matched record. Accept: text/event-stream streams the same answer as server-sent events. With legacy=true, name is read only as an exact id, public handle, registry id, or slug: no model call, no web search, and 404 when nothing matches. Example body: {"name":"Acme AI","url":["https://acme.ai"]}. A signed-in caller that sends Prefer: respond-async gets 202 with a Location status URL instead: a lookup job runs this same identification without the live deadline, and GET /v1/lookup-jobs/{jobId} returns it as identification once COMPLETED. A repeat of the same request returns the same job while it is still PENDING or RUNNING.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/identification/subject`,schemaName:`IdentificationSubjectSchema`,kind:`json`,contentType:`application/json`,description:`The company, Product, Service, or person to identify. Send the name, a URL it owns, or both, plus every location and source you have; a website or profile URL usually settles the answer without any model call.`,required:!0,requiredPath:[],parameter:[{name:`context`,optionKey:`context`,flag:`--context <context>`,required:!1,description:`Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing.`,schemaType:`string`,location:`body`},{name:`kind`,optionKey:`kind`,flag:`--kind <kind>`,required:!1,description:`Kind of record to identify when you know it: ENTITY for companies, funds, and firms (and their products or services); PERSON for people. Only that kind is looked up; typeRecord or providerId implies ENTITY. Allowed values: ENTITY, PERSON.`,schemaType:`string`,choices:[`ENTITY`,`PERSON`],location:`body`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own.`,schemaType:`string`,location:`body`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!1,description:`Name exactly as the source writes it, such as Acme AI or Jane Doe. Send name, url, or both; a name that is an absolute http(s) URL is read as url.`,schemaType:`string`,location:`body`},{name:`providerId`,optionKey:`providerId`,flag:`--provider-id <uuid>`,required:!1,description:`Provider entity id for a Product or Service lookup. Omit it when the provider is unknown. With no typeRecord, searches both Product and Service. Invalid for a company type or a person lookup.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`sourceIdentifier.idType`,optionKey:`sourceIdentifierIdType`,flag:`--source-identifier-id-type <source-identifier-id-type>`,required:!1,description:`Identifier type token, for example ein, secCik, or ticker.`,schemaType:`string`,location:`body`},{name:`sourceIdentifier.identifier`,optionKey:`sourceIdentifierIdentifier`,flag:`--source-identifier-identifier <source-identifier-identifier>`,required:!1,description:`Identifier value as issued by the registry.`,schemaType:`string`,location:`body`},{name:`sourceIdentifier.source`,optionKey:`sourceIdentifierSource`,flag:`--source-identifier-source <source-identifier-source>`,required:!1,description:`Optional attribution source label for the mapping.`,schemaType:`string`,location:`body`},{name:`sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article that mentions the subject; an unknown id is a 400.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`body`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Entity type to identify. A Product or Service never matches its provider organization, but a record stored under a neighboring type of the same family (Product or Service; Fund, Investment Firm, or Company) still matches, and a Business Line lookup sees both families. Invalid for a person lookup. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`URLs the subject owns: its website, its LinkedIn company or person profile, an aVenture page, or a registry page. At most 10. Required when name is omitted. Put articles in sourceUrl.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`Name identification needs a paid aVenture plan; a caller without one gets 402 with code subscription_required (subscription_canceled, subscription_past_due, or subscription_paused when a plan lapsed).`}],successResponse:`Identification`,parameters:[{name:`legacy`,optionKey:`legacy`,flag:`--legacy [true|false]`,required:!1,description:`Treat name only as an exact id, public handle, registry id, or slug: no model call, no web search, and 404 when nothing matches. An exact match never spends the name-identification quota, with or without this flag.`,schemaType:`boolean`,location:`query`},{name:`scheduleEnrichment`,optionKey:`scheduleEnrichment`,flag:`--schedule-enrichment [true|false]`,required:!1,description:`For an existing match, set true to queue research on it; omitted or false does not. A record this lookup adds is not researched; request research on it with POST /v1/research-runs.`,schemaType:`boolean`,location:`query`},{name:`verifyUrl`,optionKey:`verifyUrl`,flag:`--verify-url [true|false]`,required:!1,description:`Probe submitted URLs and return fresh canonical host-form evidence; defaults to false.`,schemaType:`boolean`,location:`query`},{name:`Prefer`,optionKey:`prefer`,flag:`--prefer <prefer>`,required:!1,description:`Send respond-async to request a pollable lookup job, which adds no record; verifyUrl=true answers live.`,schemaType:`string`,location:`header`}]},{operationId:`lookupMentions`,method:`POST`,path:`/v1/lookup-mentions`,resource:`lookup-mentions`,intent:`lookup`,cliPath:[`lookup-mentions`],summary:`Identify Every Company and Person a Page or Screenshot Names`,description:`Reads a page (sourceUrl or sourceNewsId), a recorded document such as an email (sourceDocumentId, sent alone), a screenshot (multipart file part), or a page and screenshot, lists every company, organization, investor, and person it names, and identifies each one as POST /v1/lookup would, with the page as its source. A caller that read the names itself sends them as mention instead, alone, so neither page nor screenshot leaves it. Answers within seconds: a name still identifying when the time is up carries failureReason instead of identification; send it alone to POST /v1/lookup. Each NO_MATCH name whose own site a web search finds, and whose live page names it, is added as a new unpublished record and returned as shell; adding it spends nothing and starts no research, and a name not added carries shellDetail saying why. Needs a signed-in user. Each name spends one name-identification quota slot, as POST /v1/lookup does; reading a page or screenshot also spends one natural-search slot and needs a plan, sending mention does neither. JSON body: {"sourceUrl":"https://techcrunch.com/2024/01/01/example"} or {"mention":[{"name":"Visa","type":"COMPANY"}]}; multipart: a file part plus an optional JSON body part.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/lookup/job-mutation`,schemaName:`LookupJobMutationSchema`,kind:`json`,contentType:`application/json`,description:`The article whose companies and people a lookup identifies. Send sourceUrl, sourceNewsId, or both; POST /v1/lookup-mentions also reads a recorded sourceDocumentId alone; lookup-only bulk jobs and POST /v1/lookup-mentions also accept mention instead. A job filed by Prefer: respond-async on GET /v1/lookup or POST /v1/entities/lookup carries that request's subject instead.`,required:!0,requiredPath:[],parameter:[{name:`mention[].name`,optionKey:`mentionName`,flag:`--mention-name <mention-name>`,required:!1,description:`Name as the source writes it.`,schemaType:`string`,location:`body`},{name:`mention[].providerName`,optionKey:`mentionProviderName`,flag:`--mention-provider-name <mention-provider-name>`,required:!1,description:`PRODUCT_SERVICE only: the organization that offers it, as the source writes it. When the offering resolves among offerings and its provider settles on an organization record, the match is limited to that record's offerings.`,schemaType:`string`,location:`body`},{name:`mention[].searchQuery`,optionKey:`mentionSearchQuery`,flag:`--mention-search-query <mention-search-query>`,required:!1,description:`Ignored: the lookup searches by name. Still accepted so callers that send it keep working; omit it.`,schemaType:`string`,location:`body`},{name:`mention[].type`,optionKey:`mentionType`,flag:`--mention-type <mention-type>`,required:!1,description:`Whether the source names a company, a Product or Service (PRODUCT_SERVICE), or a person. A Product or Service resolves like a company first, then among Product and Service records when that finds no match, and never creates a new record. Allowed values: COMPANY, PERSON, PRODUCT_SERVICE.`,schemaType:`string`,choices:[`COMPANY`,`PERSON`,`PRODUCT_SERVICE`],location:`body`},{name:`omitRecords`,optionKey:`omitRecords`,flag:`--omit-records [true|false]`,required:!1,description:`POST /v1/lookup-mentions only: true answers each name with only its name, mentionType, failureReason, and identification status, stage, match, officialUrl, and detail: no entity or person rows and empty candidate and duplicate lists. Defaults to false, the full answer.`,schemaType:`boolean`,location:`body`},{name:`sourceDocumentId`,optionKey:`sourceDocumentId`,flag:`--source-document-id <uuid>`,required:!1,description:`Id of a stored source document whose text is the article; send it alone. Only POST /v1/lookup-mentions reads it, and only for accounts with editing rights.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article; an id that names no stored article is an error.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`body`}]},{kind:`multipart`,contentType:`multipart/form-data`,description:`Reads a page (sourceUrl or sourceNewsId), a recorded document such as an email (sourceDocumentId, sent alone), a screenshot (multipart file part), or a page and screenshot, lists every company, organization, investor, and person it names, and identifies each one as POST /v1/lookup would, with the page as its source. A caller that read the names itself sends them as mention instead, alone, so neither page nor screenshot leaves it. Answers within seconds: a name still identifying when the time is up carries failureReason instead of identification; send it alone to POST /v1/lookup. Each NO_MATCH name whose own site a web search finds, and whose live page names it, is added as a new unpublished record and returned as shell; adding it spends nothing and starts no research, and a name not added carries shellDetail saying why. Needs a signed-in user. Each name spends one name-identification quota slot, as POST /v1/lookup does; reading a page or screenshot also spends one natural-search slot and needs a plan, sending mention does neither. JSON body: {"sourceUrl":"https://techcrunch.com/2024/01/01/example"} or {"mention":[{"name":"Visa","type":"COMPANY"}]}; multipart: a file part plus an optional JSON body part.`,required:!0,requiredPath:[],parameter:[{name:`body.mention[].name`,optionKey:`mentionName`,flag:`--mention-name <mention-name>`,required:!1,description:`Name as the source writes it.`,schemaType:`string`,location:`body`},{name:`body.mention[].providerName`,optionKey:`mentionProviderName`,flag:`--mention-provider-name <mention-provider-name>`,required:!1,description:`PRODUCT_SERVICE only: the organization that offers it, as the source writes it. When the offering resolves among offerings and its provider settles on an organization record, the match is limited to that record's offerings.`,schemaType:`string`,location:`body`},{name:`body.mention[].searchQuery`,optionKey:`mentionSearchQuery`,flag:`--mention-search-query <mention-search-query>`,required:!1,description:`Ignored: the lookup searches by name. Still accepted so callers that send it keep working; omit it.`,schemaType:`string`,location:`body`},{name:`body.mention[].type`,optionKey:`mentionType`,flag:`--mention-type <mention-type>`,required:!1,description:`Whether the source names a company, a Product or Service (PRODUCT_SERVICE), or a person. A Product or Service resolves like a company first, then among Product and Service records when that finds no match, and never creates a new record. Allowed values: COMPANY, PERSON, PRODUCT_SERVICE.`,schemaType:`string`,choices:[`COMPANY`,`PERSON`,`PRODUCT_SERVICE`],location:`body`},{name:`body.omitRecords`,optionKey:`omitRecords`,flag:`--omit-records [true|false]`,required:!1,description:`POST /v1/lookup-mentions only: true answers each name with only its name, mentionType, failureReason, and identification status, stage, match, officialUrl, and detail: no entity or person rows and empty candidate and duplicate lists. Defaults to false, the full answer.`,schemaType:`boolean`,location:`body`},{name:`body.sourceDocumentId`,optionKey:`sourceDocumentId`,flag:`--source-document-id <uuid>`,required:!1,description:`Id of a stored source document whose text is the article; send it alone. Only POST /v1/lookup-mentions reads it, and only for accounts with editing rights.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`body.sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article; an id that names no stored article is an error.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`body.sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`body`},{name:`file`,optionKey:`file`,flag:`--file <file>`,required:!1,description:`Screenshot (PNG, JPEG, or WebP); CLI accepts a local path or URL.`,schemaType:`string`,schemaFormat:`binary`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[{status:`402`,description:`Reading a page or screenshot needs a paid aVenture plan; a caller without one gets 402 with code subscription_required. Sending mention needs no plan.`}],successResponse:`MentionLookup`,parameters:[]},{operationId:`getSystemGlobalMetrics`,method:`GET`,path:`/v1/metrics`,resource:`metrics`,intent:`read`,cliPath:[`metrics`],summary:`Get Platform Totals for Companies, Funding, and People`,description:`Global metrics snapshot. Companies tracked (companies and investment firms combined), total funding, trailing 30-day funding, investors, people, countries, cities. Totals are a periodically refreshed snapshot, so they can trail recent changes.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`SystemGlobalMetrics`,parameters:[]},{operationId:`searchFederated`,method:`POST`,path:`/v1/search`,resource:`search`,intent:`search`,cliPath:[`search`],summary:`Search Companies, People, and News Together`,description:`Search companies, people, and news. auto blends exact names, full-text, planning, and similarity; keyword forces full-text. Other modes are rejected. Entity results supply ranked people; without entities, people are empty. provenance.modeUsed and scope interpretation report execution; unsearchable scopes carry provenance.rejection. entityFilter constrains entities; single-scope hard filters use /v1/search/natural/entities or /v1/search/natural/people. Page/size apply across scopes except personSize/newsSize; sort is unsupported. layer=synthesis adds a cited answer and relatedQuery. SSE opens with admitted after metering. settled contains all scopes; revised adds pendingWebQuery results and synthesis without moving settled rows; complete is terminal. Snapshot and admitted SSE ids use revision:request-uuid, starting at 0. For ten minutes, identical Last-Event-ID requests from the same caller replay durable state without new quota or records. Failed synthesis retries only its paid answer; disconnects never cancel admitted work. Incomplete snapshots replay as settled, then error. Terminal failures carry ProblemDetail.disposition=TERMINAL; resume ids never restart paid search. JSON does not wait for pending web searches.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/federated/natural-search`,schemaName:`FederatedNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search across companies, people, and news, plus optional per-scope entity constraints and page sizes.`,required:!0,requiredPath:[`query`],parameter:[{name:`entityFilter.employeeCountRange[].min`,optionKey:`entityFilterEmployeeCountRangeMin`,flag:`--entity-filter-employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.amountInvestedRange[].min`,optionKey:`entityFilterFundraiseAmountInvestedRangeMin`,flag:`--entity-filter-fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.amountRaisedRange[].min`,optionKey:`entityFilterFundraiseAmountRaisedRangeMin`,flag:`--entity-filter-fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.dateAnnouncedRange.min`,optionKey:`entityFilterFundraiseDateAnnouncedRangeMin`,flag:`--entity-filter-fundraise-date-announced-range-min <date-time>`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--entity-filter-fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.lastRoundYearRange[].min`,optionKey:`entityFilterFundraiseLastRoundYearRangeMin`,flag:`--entity-filter-fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.totalRaisedRange[].min`,optionKey:`entityFilterFundraiseTotalRaisedRangeMin`,flag:`--entity-filter-fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.valuationRange[].min`,optionKey:`entityFilterFundraiseValuationRangeMin`,flag:`--entity-filter-fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.yearFoundedRange[].min`,optionKey:`entityFilterYearFoundedRangeMin`,flag:`--entity-filter-year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.employeeCountRange[].max`,optionKey:`entityFilterEmployeeCountRangeMax`,flag:`--entity-filter-employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.amountInvestedRange[].max`,optionKey:`entityFilterFundraiseAmountInvestedRangeMax`,flag:`--entity-filter-fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.amountRaisedRange[].max`,optionKey:`entityFilterFundraiseAmountRaisedRangeMax`,flag:`--entity-filter-fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.dateAnnouncedRange.max`,optionKey:`entityFilterFundraiseDateAnnouncedRangeMax`,flag:`--entity-filter-fundraise-date-announced-range-max <date-time>`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--entity-filter-fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.lastRoundYearRange[].max`,optionKey:`entityFilterFundraiseLastRoundYearRangeMax`,flag:`--entity-filter-fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.totalRaisedRange[].max`,optionKey:`entityFilterFundraiseTotalRaisedRangeMax`,flag:`--entity-filter-fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.valuationRange[].max`,optionKey:`entityFilterFundraiseValuationRangeMax`,flag:`--entity-filter-fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.yearFoundedRange[].max`,optionKey:`entityFilterYearFoundedRangeMax`,flag:`--entity-filter-year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`answerModel`,optionKey:`answerModel`,flag:`--answer-model <answer-model>`,required:!1,description:`Optional supported model for the written answer, which also supplies the page heading, title, and description. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`cacheMode`,optionKey:`cacheMode`,flag:`--cache-mode <cache-mode>`,required:!1,description:`Cache policy. use reuses earlier search work; bypass and refresh compute fresh results and are honored only for accounts with private-data access. Allowed values: use, bypass, refresh.`,schemaType:`string`,defaultValue:`use`,choices:[`use`,`bypass`,`refresh`],location:`body`},{name:`entityFilter.acceleratorBrand`,optionKey:`entityFilterAcceleratorBrand`,flag:`--entity-filter-accelerator-brand <entity-filter-accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.acceleratorCohort`,optionKey:`entityFilterAcceleratorCohort`,flag:`--entity-filter-accelerator-cohort <entity-filter-accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.acceleratorName`,optionKey:`entityFilterAcceleratorName`,flag:`--entity-filter-accelerator-name <entity-filter-accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.acceleratorStatus`,optionKey:`entityFilterAcceleratorStatus`,flag:`--entity-filter-accelerator-status <entity-filter-accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.affinity`,optionKey:`entityFilterAffinity`,flag:`--entity-filter-affinity <entity-filter-affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.closedLast`,optionKey:`entityFilterClosedLast`,flag:`--entity-filter-closed-last [true|false]`,required:!1,description:`Rank closed entities (Closed, Closed (Acquihire), Inactive) after every other textSearch or semanticQuery match, ahead of relevance and sort; omitted means true. false ranks them by relevance alone. Filter them out with operatingStatus or suppressNonOperating.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.entityId`,optionKey:`entityFilterEntityId`,flag:`--entity-filter-entity-id <entity-filter-entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.entityName`,optionKey:`entityFilterEntityName`,flag:`--entity-filter-entity-name <entity-filter-entity-name...>`,required:!1,description:`Exact normalized match against entity brand, legal, or alias names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.featured`,optionKey:`entityFilterFeatured`,flag:`--entity-filter-featured [true|false]`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.fundraiseActivity.investedCompanyName`,optionKey:`entityFilterFundraiseInvestedCompanyName`,flag:`--entity-filter-fundraise-invested-company-name <entity-filter-fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.fundraiseActivity.investedCountry`,optionKey:`entityFilterFundraiseInvestedCountry`,flag:`--entity-filter-fundraise-invested-country <entity-filter-fundraise-invested-country...>`,required:!1,description:`Countries of the companies an investor backed, as country names or ids; a deal matches when its company's current headquarters is in one of them. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound or investedIndustry, the same deal must match each.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.fundraiseActivity.investedIndustry`,optionKey:`entityFilterFundraiseInvestedIndustry`,flag:`--entity-filter-fundraise-invested-industry <entity-filter-fundraise-invested-industry...>`,required:!1,description:`Industry terms for the companies an investor backed, such as Software, Artificial Intelligence, or Fintech; a term matches a portfolio company whose industry or industry classification name contains it as whole words, case-insensitively. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound, the same deal must match both.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.fundraiseActivity.investedRound`,optionKey:`entityFilterFundraiseInvestedRound`,flag:`--entity-filter-fundraise-invested-round <entity-filter-fundraise-invested-round...>`,required:!1,description:`Round labels of the deals an investor joined, such as Seed, Pre-Seed, or Series A; restricts returned entities to investors with such a deal inside the investment-activity horizon.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.fundraiseActivity.investorName`,optionKey:`entityFilterFundraiseInvestorName`,flag:`--entity-filter-fundraise-investor-name <entity-filter-fundraise-investor-name...>`,required:!1,description:`Investor names. Exact, case-sensitive match on an investor entity's brand or legal name or an individual investor's full name; restricts returned entities to companies with a fundraise that investor joined.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.fundraiseActivity.rankByInvestmentActivity`,optionKey:`entityFilterFundraiseRankByInvestmentActivity`,flag:`--entity-filter-fundraise-rank-by-investment-activity [true|false]`,required:!1,description:`True ranks returned investors by recent deal activity ahead of any sort: each deal inside investedRound, investedIndustry, and investedCountry (every deal when all are empty) adds a weight that decays to zero over the investment-activity horizon, nudged by the investor's known USD check. Restricts returned entities to investors with such a deal.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.fundraiseActivity.round`,optionKey:`entityFilterFundraiseRound`,flag:`--entity-filter-fundraise-round <entity-filter-fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.hasFundraising`,optionKey:`entityFilterHasFundraising`,flag:`--entity-filter-has-fundraising [true|false]`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.headquartersCity`,optionKey:`entityFilterHeadquartersCity`,flag:`--entity-filter-headquarters-city <entity-filter-headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.headquartersCountry`,optionKey:`entityFilterHeadquartersCountry`,flag:`--entity-filter-headquarters-country <entity-filter-headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.headquartersState`,optionKey:`entityFilterHeadquartersState`,flag:`--entity-filter-headquarters-state <entity-filter-headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.industry`,optionKey:`entityFilterIndustry`,flag:`--entity-filter-industry <entity-filter-industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.letter`,optionKey:`entityFilterLetter`,flag:`--entity-filter-letter <entity-filter-letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`entityFilter.location`,optionKey:`entityFilterLocation`,flag:`--entity-filter-location <entity-filter-location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.logoOption.sortPriority`,optionKey:`entityFilterLogoSortPriority`,flag:`--entity-filter-logo-sort-priority <entity-filter-logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`entityFilter.mainProduct`,optionKey:`entityFilterMainProduct`,flag:`--entity-filter-main-product <entity-filter-main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.operatingStatus`,optionKey:`entityFilterOperatingStatus`,flag:`--entity-filter-operating-status <entity-filter-operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`entityFilter.originCountry`,optionKey:`entityFilterOriginCountry`,flag:`--entity-filter-origin-country <entity-filter-origin-country...>`,required:!1,description:`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.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.person`,optionKey:`entityFilterPerson`,flag:`--entity-filter-person <entity-filter-person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.portfolioHeadquartersCity`,optionKey:`entityFilterPortfolioHeadquartersCity`,flag:`--entity-filter-portfolio-headquarters-city <entity-filter-portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.portfolioHeadquartersCountry`,optionKey:`entityFilterPortfolioHeadquartersCountry`,flag:`--entity-filter-portfolio-headquarters-country <entity-filter-portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.portfolioHeadquartersState`,optionKey:`entityFilterPortfolioHeadquartersState`,flag:`--entity-filter-portfolio-headquarters-state <entity-filter-portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.qualityGate`,optionKey:`entityFilterQualityGate`,flag:`--entity-filter-quality-gate <entity-filter-quality-gate>`,required:!1,description:`Server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`entityFilter.rankByProminence`,optionKey:`entityFilterRankByProminence`,flag:`--entity-filter-rank-by-prominence [true|false]`,required:!1,description:`Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.slug`,optionKey:`entityFilterSlug`,flag:`--entity-filter-slug <entity-filter-slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.stage`,optionKey:`entityFilterStage`,flag:`--entity-filter-stage <entity-filter-stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.suppressLateStage`,optionKey:`entityFilterSuppressLateStage`,flag:`--entity-filter-suppress-late-stage [true|false]`,required:!1,description:`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.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.suppressNonOperating`,optionKey:`entityFilterSuppressNonOperating`,flag:`--entity-filter-suppress-non-operating [true|false]`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.suppressZeroTotalRaised`,optionKey:`entityFilterSuppressZeroTotalRaised`,flag:`--entity-filter-suppress-zero-total-raised [true|false]`,required:!1,description:`Suppress entities with zero or unknown USD total raised.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.tag`,optionKey:`entityFilterTag`,flag:`--entity-filter-tag <entity-filter-tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.textSearch`,optionKey:`entityFilterTextSearch`,flag:`--entity-filter-text-search <entity-filter-text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`entityFilter.typeCustomer`,optionKey:`entityFilterTypeCustomer`,flag:`--entity-filter-type-customer <entity-filter-type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.typeModel`,optionKey:`entityFilterTypeModel`,flag:`--entity-filter-type-model <entity-filter-type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.typeOwnership`,optionKey:`entityFilterTypeOwnership`,flag:`--entity-filter-type-ownership <entity-filter-type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.typeRecord`,optionKey:`entityFilterTypeRecord`,flag:`--entity-filter-type-record <entity-filter-type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`entityFilter.typeRevenue`,optionKey:`entityFilterTypeRevenue`,flag:`--entity-filter-type-revenue <entity-filter-type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.typeTechnologyUsed`,optionKey:`entityFilterTypeTechnologyUsed`,flag:`--entity-filter-type-technology-used <entity-filter-type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.url`,optionKey:`entityFilterUrl`,flag:`--entity-filter-url <entity-filter-url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`entityFilter.urlDomain`,optionKey:`entityFilterUrlDomain`,flag:`--entity-filter-url-domain <entity-filter-url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`entityFilter.urlMatchMode`,optionKey:`entityFilterUrlMatchMode`,flag:`--entity-filter-url-match-mode <entity-filter-url-match-mode>`,required:!1,description:`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: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`entityFilter.urlType`,optionKey:`entityFilterUrlType`,flag:`--entity-filter-url-type <entity-filter-url-type>`,required:!1,description:`Restrict URL matching to one URL type.`,schemaType:`string`,location:`body`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto`, `keyword`, `semantic`, and `hybrid` (`semantic` and `hybrid` only for one entity's or person's content). Allowed values: auto, exact, keyword, semantic, natural, hybrid.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`,`hybrid`],location:`body`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional supported model for planning the search. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`modelCatalogRevision`,optionKey:`modelCatalogRevision`,flag:`--model-catalog-revision <integer>`,required:!1,description:`Model catalog revision this search uses for its model defaults and inference policy; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`newsSize`,optionKey:`newsSize`,flag:`--news-size <integer>`,required:!1,description:`News scope page size; omitted uses the size query parameter, under the same page-size cap.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`personSize`,optionKey:`personSize`,flag:`--person-size <integer>`,required:!1,description:`Person scope page size; omitted uses the size query parameter, under the same page-size cap.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`},{name:`reasoningEffort`,optionKey:`reasoningEffort`,flag:`--reasoning-effort <reasoning-effort>`,required:!1,description:"Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Accounts without private-data access are capped at `medium`; higher values are lowered. Allowed values: minimal, low, medium, high, xhigh, max.",schemaType:`string`,choices:[`minimal`,`low`,`medium`,`high`,`xhigh`,`max`],location:`body`},{name:`searchCatalogRevision`,optionKey:`searchCatalogRevision`,flag:`--search-catalog-revision <integer>`,required:!1,description:`Search catalog revision this search uses for its global search policy and vocabulary; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`tenantPolicyRevision`,optionKey:`tenantPolicyRevision`,flag:`--tenant-policy-revision <integer>`,required:!1,description:`Runtime policy revision this search uses for the serving deployment's execution budgets; null reads that deployment's current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`This search needs a paid aVenture plan; a caller without one gets 402 with code subscription_required.`}],successResponse:`FederatedSearch`,parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`layer`,optionKey:`layer`,flag:`--layer <layer...>`,required:!1,description:`Repeat to add layers. Synthesis cites this response's public entity records, passages, and news; other layers enrich entities while people and news run alongside. Allowed values: passage, synthesis, judgment, web.`,schemaType:`array`,itemSchemaType:`string`,choices:[`passage`,`synthesis`,`judgment`,`web`],location:`query`}]},{operationId:`enrichRecords`,method:`POST`,path:`/v1/enrichments`,resource:`enrichments`,intent:`write`,cliPath:[`enrichments`,`enrich`],summary:`Enrich Many Companies and People`,description:`Queues one enrichment run per listed entity and person, in order, each owned by the authenticated principal and billed exactly as the single-record enrich call is. A repeated id is filed once. Returns one outcome per distinct record: its run, or a refusal (NOT_FOUND, ALLOWANCE_EXHAUSTED, AMBIGUOUS, SUBSCRIPTION_REQUIRED) for a record that cannot be filed; other records still file, and runs already filed stay queued. A record already being researched, or researched within the last 24 hours, files nothing while the other records still file; the request then answers 429 whose filedRunId lists the runs it filed. A caller without a research subscription gets 402 before any run is filed. A transient failure fails the request; retrying it reuses runs still in progress without charging them again. A list longer than the configured batch limit is refused before any run is filed. Check each run's progress with GET /v1/research-runs/{runId} (CLI: research-runs get).`,requestBody:[{schemaImport:`@aventurevc/api-schemas/enrichment/batch`,schemaName:`EnrichmentBatchSchema`,kind:`json`,contentType:`application/json`,description:`Existing records to enrich in one call, with the run options every run shares`,required:!0,requiredPath:[],parameter:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Canonical entity UUIDs to enrich, filed in order before any person.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:`COMPREHENSIVE (the default) researches each whole profile; INDIVIDUAL runs only the tasks named in taskPresetKey. Allowed values: COMPREHENSIVE, INDIVIDUAL.`,schemaType:`string`,choices:[`COMPREHENSIVE`,`INDIVIDUAL`],location:`body`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Model id for each run's lead agent; omit to use aVenture's default model.`,schemaType:`string`,location:`body`},{name:`personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Canonical person UUIDs to enrich, filed in order after every entity.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`taskPresetKey`,optionKey:`taskPresetKey`,flag:`--task-preset-key <task-preset-key...>`,required:!1,description:`Task preset keys that scope or emphasize every run; at least one is required when mode is INDIVIDUAL, and an unknown key is a 400.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`userPrompt`,optionKey:`userPrompt`,flag:`--user-prompt <user-prompt>`,required:!1,description:`Plain-language instruction for every run, such as which facts or sources to check first.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[{status:`402`,description:`Needs a plan that includes research runs; a caller without one gets 402 with code subscription_required (subscription_canceled, subscription_past_due, or subscription_paused when a plan lapsed).`}],successResponse:`Enrichment`,detailField:[`run.chassis`,`run.chassisRouted`,`run.hasSourceDocument`,`run.lane`,`run.latestStatus`,`run.llmApi`,`run.maxScoutConcurrent`,`run.nextAttemptAt`,`run.subagentModel`,`run.taskPresetKey`,`run.updatedAt`],parameters:[]},{operationId:`getEntity`,method:`GET`,path:`/v1/entities/{entityId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`get`],summary:`Get One Company, Product, or Service by ID`,description:`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. 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.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityDetail`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Exact entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`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).`,schemaType:`string`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Allow generated monogram logo fallback.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntities`,method:`GET`,path:`/v1/entities`,resource:`entities`,intent:`read`,cliPath:[`entities`,`list`],summary:`List Companies, Products, and Services`,description:`List entities with the same filters and sort as POST /v1/entities/search, passed as query parameters. Use the POST search for semantic ranking or a JSON EntityListFilter body, and POST /v1/search/natural/entities for plain English.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityList`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`slug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Exact normalized match against entity brand, legal, or alias names.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`person`,optionKey:`person`,flag:`--person <person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`query`},{name:`industry`,optionKey:`industry`,flag:`--industry <industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`location`,optionKey:`location`,flag:`--location <location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`tag`,optionKey:`tag`,flag:`--tag <tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`mainProduct`,optionKey:`mainProduct`,flag:`--main-product <main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeTechnologyUsed`,optionKey:`typeTechnologyUsed`,flag:`--type-technology-used <type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeModel`,optionKey:`typeModel`,flag:`--type-model <type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeOwnership`,optionKey:`typeOwnership`,flag:`--type-ownership <type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeCustomer`,optionKey:`typeCustomer`,flag:`--type-customer <type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`typeRevenue`,optionKey:`typeRevenue`,flag:`--type-revenue <type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`acceleratorBrand`,optionKey:`acceleratorBrand`,flag:`--accelerator-brand <accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`acceleratorName`,optionKey:`acceleratorName`,flag:`--accelerator-name <accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`acceleratorCohort`,optionKey:`acceleratorCohort`,flag:`--accelerator-cohort <accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`acceleratorStatus`,optionKey:`acceleratorStatus`,flag:`--accelerator-status <accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`affinity`,optionKey:`affinity`,flag:`--affinity <affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`headquartersCountry`,optionKey:`headquartersCountry`,flag:`--headquarters-country <headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`headquartersState`,optionKey:`headquartersState`,flag:`--headquarters-state <headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`headquartersCity`,optionKey:`headquartersCity`,flag:`--headquarters-city <headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`originCountry`,optionKey:`originCountry`,flag:`--origin-country <origin-country...>`,required:!1,description:`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.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`stage`,optionKey:`stage`,flag:`--stage <stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`yearFoundedRange[0].min`,optionKey:`yearFoundedRangeMin`,flag:`--year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`yearFoundedRange[0].max`,optionKey:`yearFoundedRangeMax`,flag:`--year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`employeeCountRange[0].min`,optionKey:`employeeCountRangeMin`,flag:`--employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`employeeCountRange[0].max`,optionKey:`employeeCountRangeMax`,flag:`--employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`operatingStatus`,optionKey:`operatingStatus`,flag:`--operating-status <operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`query`},{name:`hasFundraising`,optionKey:`hasFundraising`,flag:`--has-fundraising [true|false]`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`query`},{name:`featured`,optionKey:`featured`,flag:`--featured [true|false]`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`query`},{name:`suppressZeroTotalRaised`,optionKey:`suppressZeroTotalRaised`,flag:`--suppress-zero-total-raised [true|false]`,required:!1,description:`Suppress entities with zero or unknown USD total raised.`,schemaType:`boolean`,location:`query`},{name:`suppressNonOperating`,optionKey:`suppressNonOperating`,flag:`--suppress-non-operating [true|false]`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`query`},{name:`rankByProminence`,optionKey:`rankByProminence`,flag:`--rank-by-prominence [true|false]`,required:!1,description:`Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean.`,schemaType:`boolean`,location:`query`},{name:`suppressLateStage`,optionKey:`suppressLateStage`,flag:`--suppress-late-stage [true|false]`,required:!1,description:`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.`,schemaType:`boolean`,location:`query`},{name:`qualityGate`,optionKey:`qualityGate`,flag:`--quality-gate <quality-gate>`,required:!1,description:`Server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`query`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`query`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`query`},{name:`urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Restrict URL matching to one URL type.`,schemaType:`string`,location:`query`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`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: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`query`},{name:`portfolioHeadquartersCountry`,optionKey:`portfolioHeadquartersCountry`,flag:`--portfolio-headquarters-country <portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`portfolioHeadquartersState`,optionKey:`portfolioHeadquartersState`,flag:`--portfolio-headquarters-state <portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`portfolioHeadquartersCity`,optionKey:`portfolioHeadquartersCity`,flag:`--portfolio-headquarters-city <portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`fundraiseActivity.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`fundraiseActivity.dateAnnouncedRange.min`,optionKey:`fundraiseDateAnnouncedRangeMin`,flag:`--fundraise-date-announced-range-min <date-time>`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`query`},{name:`fundraiseActivity.dateAnnouncedRange.max`,optionKey:`fundraiseDateAnnouncedRangeMax`,flag:`--fundraise-date-announced-range-max <date-time>`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`query`},{name:`fundraiseActivity.amountRaisedRange[0].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.amountRaisedRange[0].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.amountInvestedRange[0].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.amountInvestedRange[0].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.totalRaisedRange[0].min`,optionKey:`fundraiseTotalRaisedRangeMin`,flag:`--fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.totalRaisedRange[0].max`,optionKey:`fundraiseTotalRaisedRangeMax`,flag:`--fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.valuationRange[0].min`,optionKey:`fundraiseValuationRangeMin`,flag:`--fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.valuationRange[0].max`,optionKey:`fundraiseValuationRangeMax`,flag:`--fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.lastRoundYearRange[0].min`,optionKey:`fundraiseLastRoundYearRangeMin`,flag:`--fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`fundraiseActivity.lastRoundYearRange[0].max`,optionKey:`fundraiseLastRoundYearRangeMax`,flag:`--fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`fundraiseActivity.investedCompanyName`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`fundraiseActivity.investedRound`,optionKey:`fundraiseInvestedRound`,flag:`--fundraise-invested-round <fundraise-invested-round...>`,required:!1,description:`Round labels of the deals an investor joined, such as Seed, Pre-Seed, or Series A; restricts returned entities to investors with such a deal inside the investment-activity horizon.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`fundraiseActivity.investedIndustry`,optionKey:`fundraiseInvestedIndustry`,flag:`--fundraise-invested-industry <fundraise-invested-industry...>`,required:!1,description:`Industry terms for the companies an investor backed, such as Software, Artificial Intelligence, or Fintech; a term matches a portfolio company whose industry or industry classification name contains it as whole words, case-insensitively. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound, the same deal must match both.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`fundraiseActivity.investedCountry`,optionKey:`fundraiseInvestedCountry`,flag:`--fundraise-invested-country <fundraise-invested-country...>`,required:!1,description:`Countries of the companies an investor backed, as country names or ids; a deal matches when its company's current headquarters is in one of them. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound or investedIndustry, the same deal must match each.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`fundraiseActivity.rankByInvestmentActivity`,optionKey:`fundraiseRankByInvestmentActivity`,flag:`--fundraise-rank-by-investment-activity [true|false]`,required:!1,description:`True ranks returned investors by recent deal activity ahead of any sort: each deal inside investedRound, investedIndustry, and investedCountry (every deal when all are empty) adds a weight that decays to zero over the investment-activity horizon, nudged by the investor's known USD check. Restricts returned entities to investors with such a deal.`,schemaType:`boolean`,location:`query`},{name:`fundraiseActivity.investorName`,optionKey:`fundraiseInvestorName`,flag:`--fundraise-investor-name <fundraise-investor-name...>`,required:!1,description:`Investor names. Exact, case-sensitive match on an investor entity's brand or legal name or an individual investor's full name; restricts returned entities to companies with a fundraise that investor joined.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[0].min`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[0].max`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[0].min`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[0].max`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[0].min`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[0].max`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[0].min`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[0].max`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[0].min`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[0].max`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`textSearch`,optionKey:`textSearch`,flag:`--text-search <text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`query`},{name:`closedLast`,optionKey:`closedLast`,flag:`--closed-last [true|false]`,required:!1,description:`Rank closed entities (Closed, Closed (Acquihire), Inactive) after every other textSearch or semanticQuery match, ahead of relevance and sort; omitted means true. false ranks them by relevance alone. Filter them out with operatingStatus or suppressNonOperating.`,schemaType:`boolean`,location:`query`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only [true|false]`,required:!1,description:`Return only the matching entity count in totalElements. Content is empty by design, so the page empty flag describes content, not whether matches exist. Unsupported with semanticQuery.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Allow generated monogram logos in results.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`lookupEntity`,method:`POST`,path:`/v1/entities/lookup`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup`],summary:`Deprecated: Identify a Company, Product, or Service by Name and Scope`,description:`Deprecated: send the same body to lookup-from-file (POST /v1/lookup) with kind ENTITY. Identifies a company, Product, or Service among the records you can see. Send typeRecord=Company for a company, or typeRecord=Product or Service for an offering, plus providerId when its provider is known; provider words in context are clues, not constraints. MATCHED: match.owner.entityId identifies the record and match.record.typeRecord names its type; read it with GET /v1/entities/{entityId}. A provider company and its offering are different records even when they share a brand or website. NO_MATCH: no record you can see fits the requested identity, type, and provider. NEEDS_REVIEW: several candidates fit; resend with a URL the subject owns to settle it. stage names the step that settled the answer: DETERMINISTIC, JUDGMENT, or WEB_EVIDENCE. Put pages the subject owns in url and articles in sourceUrl or sourceNewsId. Set scheduleEnrichment=true to also queue research on a matched record. For full detail by exact slug or URL use GET /v1/entities/lookup-exact. Company example: {"name":"Acme AI","typeRecord":"Company","url":["https://acme.ai"]}. Offering example: {"name":"Acme Assistant","typeRecord":"Product","url":["https://acme.ai/assistant"]}. A signed-in caller that sends Prefer: respond-async gets 202 with a Location status URL instead: a lookup job runs this same identification without the live deadline, and GET /v1/lookup-jobs/{jobId} returns it as identification once COMPLETED. A repeat of the same request returns the same job while it is still PENDING or RUNNING.`,deprecated:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/identification/subject`,schemaName:`IdentificationSubjectSchema`,kind:`json`,contentType:`application/json`,description:`The company, Product, Service, or person to identify. Send the name, a URL it owns, or both, plus every location and source you have; a website or profile URL usually settles the answer without any model call.`,required:!0,requiredPath:[],parameter:[{name:`context`,optionKey:`context`,flag:`--context <context>`,required:!1,description:`Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing.`,schemaType:`string`,location:`body`},{name:`kind`,optionKey:`kind`,flag:`--kind <kind>`,required:!1,description:`Kind of record to identify when you know it: ENTITY for companies, funds, and firms (and their products or services); PERSON for people. Only that kind is looked up; typeRecord or providerId implies ENTITY. Allowed values: ENTITY, PERSON.`,schemaType:`string`,choices:[`ENTITY`,`PERSON`],location:`body`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own.`,schemaType:`string`,location:`body`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!1,description:`Name exactly as the source writes it, such as Acme AI or Jane Doe. Send name, url, or both; a name that is an absolute http(s) URL is read as url.`,schemaType:`string`,location:`body`},{name:`providerId`,optionKey:`providerId`,flag:`--provider-id <uuid>`,required:!1,description:`Provider entity id for a Product or Service lookup. Omit it when the provider is unknown. With no typeRecord, searches both Product and Service. Invalid for a company type or a person lookup.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`sourceIdentifier.idType`,optionKey:`sourceIdentifierIdType`,flag:`--source-identifier-id-type <source-identifier-id-type>`,required:!1,description:`Identifier type token, for example ein, secCik, or ticker.`,schemaType:`string`,location:`body`},{name:`sourceIdentifier.identifier`,optionKey:`sourceIdentifierIdentifier`,flag:`--source-identifier-identifier <source-identifier-identifier>`,required:!1,description:`Identifier value as issued by the registry.`,schemaType:`string`,location:`body`},{name:`sourceIdentifier.source`,optionKey:`sourceIdentifierSource`,flag:`--source-identifier-source <source-identifier-source>`,required:!1,description:`Optional attribution source label for the mapping.`,schemaType:`string`,location:`body`},{name:`sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article that mentions the subject; an unknown id is a 400.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`body`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Entity type to identify. A Product or Service never matches its provider organization, but a record stored under a neighboring type of the same family (Product or Service; Fund, Investment Firm, or Company) still matches, and a Business Line lookup sees both families. Invalid for a person lookup. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`URLs the subject owns: its website, its LinkedIn company or person profile, an aVenture page, or a registry page. At most 10. Required when name is omitted. Put articles in sourceUrl.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`Name identification needs a paid aVenture plan; a caller without one gets 402 with code subscription_required (subscription_canceled, subscription_past_due, or subscription_paused when a plan lapsed).`}],successResponse:`Identification`,parameters:[{name:`scheduleEnrichment`,optionKey:`scheduleEnrichment`,flag:`--schedule-enrichment [true|false]`,required:!1,description:`For an existing match, set true to queue research on it; omitted or false does not. A record this lookup adds is not researched; request research on it with POST /v1/research-runs.`,schemaType:`boolean`,location:`query`},{name:`Prefer`,optionKey:`prefer`,flag:`--prefer <prefer>`,required:!1,description:`Send respond-async to request a pollable entity lookup job.`,schemaType:`string`,location:`header`}]},{operationId:`lookupEntityBatch`,method:`POST`,path:`/v1/entities/lookup-batch`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup-batch`],summary:`Look Up Companies in Bulk by ID, Slug, or URL`,description:`Returns a page envelope of entity detail records by id, slug, and/or current joined URL. When page and size are omitted, the full deduplicated batch is returned in request order. Sort is not supported for this fixed-order batch response. For public reads totalElements counts the entities visible to the caller, so requested identifiers that do not resolve or fail the public visibility filter are excluded. For privileged reads totalElements counts the requested identifiers that resolved to an entity id, which can exceed the number of records returned when an id no longer exists. 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.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/detail-batch`,schemaName:`EntityDetailBatchSchema`,kind:`json`,contentType:`application/json`,description:`Batch request for entity detail retrieval by id, slug, or current joined URL. Each identifier array accepts at most 200 values, and at most 200 identifiers may be submitted across entityId, slug, and url.`,required:!1,requiredPath:[],parameter:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Entity UUID values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit monogram fallbacks.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Entity slug values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`Current joined entity URL values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],successResponse:`EntityDetail`,parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N); omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned; omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`lookupEntityMatches`,method:`POST`,path:`/v1/entities/lookup-matches`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`lookup-matches`],summary:`Look Up Which Company Each Identifier Matches`,description:`Resolves each queried id, slug, and current joined URL to exactly one outcome row that echoes the raw input: MATCHED with full detail, AMBIGUOUS with candidate ids when a URL is currently owned by more than one entity, or MISSING. Unlike the batch detail read, no input is silently dropped and every row maps back to its source identifier. URL matching is host+path exact: scheme and a leading www are ignored, but distinct paths stay distinct (stripe.com does not match stripe.com/payments). 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.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/detail-batch`,schemaName:`EntityDetailBatchSchema`,kind:`json`,contentType:`application/json`,description:`Batch request for entity detail retrieval by id, slug, or current joined URL. Each identifier array accepts at most 200 values, and at most 200 identifiers may be submitted across entityId, slug, and url.`,required:!1,requiredPath:[],parameter:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Entity UUID values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit monogram fallbacks.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Entity slug values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`Current joined entity URL values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],successResponse:`EntityResolution`,parameters:[]},{operationId:`searchEntities`,method:`POST`,path:`/v1/entities/search`,resource:`entities`,intent:`search`,cliPath:[`entities`,`search`],summary:`Search Companies, Products, and Services`,description:`Run keyword, semantic, or explicit structured entity filtering with a structured filter body; Organization expands to the canonical organization type group; semanticQuery ranks by stored content embeddings. For plain-English queries, use POST /v1/search/natural/entities. semanticQuery defines a bounded result set: the nearest rows at or above a relevance cutoff, capped in size and ordered by score; page numbers reach the whole set and totalElements counts it. Page 0 of a semantic set of 50 rows or fewer can emit a signed cursor; other pages continue by page number. To follow the cursor, reuse the same filters, sort, size, and visibility scope. countOnly is unsupported with cursor; count-only pages have no content; read totalElements.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/list-filter`,schemaName:`EntityListFilterSchema`,kind:`json`,contentType:`application/json`,description:`Entity list filters and saved-view query state including semantic entity search. semanticQuery executes on GET /v1/entities and POST /v1/entities/search; saved views persist it for replay. Every other reused EntityFilter surface accepts the base EntityFilter, which omits semanticQuery. There is no query field: send free text describing the companies as semanticQuery, a keyword as textSearch, or a known company name as entityName.`,required:!1,requiredPath:[],parameter:[{name:`employeeCountRange[].min`,optionKey:`employeeCountRangeMin`,flag:`--employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.dateAnnouncedRange.min`,optionKey:`fundraiseDateAnnouncedRangeMin`,flag:`--fundraise-date-announced-range-min <date-time>`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.lastRoundYearRange[].min`,optionKey:`fundraiseLastRoundYearRangeMin`,flag:`--fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.totalRaisedRange[].min`,optionKey:`fundraiseTotalRaisedRangeMin`,flag:`--fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.valuationRange[].min`,optionKey:`fundraiseValuationRangeMin`,flag:`--fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`yearFoundedRange[].min`,optionKey:`yearFoundedRangeMin`,flag:`--year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`employeeCountRange[].max`,optionKey:`employeeCountRangeMax`,flag:`--employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.dateAnnouncedRange.max`,optionKey:`fundraiseDateAnnouncedRangeMax`,flag:`--fundraise-date-announced-range-max <date-time>`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.lastRoundYearRange[].max`,optionKey:`fundraiseLastRoundYearRangeMax`,flag:`--fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.totalRaisedRange[].max`,optionKey:`fundraiseTotalRaisedRangeMax`,flag:`--fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.valuationRange[].max`,optionKey:`fundraiseValuationRangeMax`,flag:`--fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`yearFoundedRange[].max`,optionKey:`yearFoundedRangeMax`,flag:`--year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`acceleratorBrand`,optionKey:`acceleratorBrand`,flag:`--accelerator-brand <accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorCohort`,optionKey:`acceleratorCohort`,flag:`--accelerator-cohort <accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorName`,optionKey:`acceleratorName`,flag:`--accelerator-name <accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorStatus`,optionKey:`acceleratorStatus`,flag:`--accelerator-status <accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`affinity`,optionKey:`affinity`,flag:`--affinity <affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`closedLast`,optionKey:`closedLast`,flag:`--closed-last [true|false]`,required:!1,description:`Rank closed entities (Closed, Closed (Acquihire), Inactive) after every other textSearch or semanticQuery match, ahead of relevance and sort; omitted means true. false ranks them by relevance alone. Filter them out with operatingStatus or suppressNonOperating.`,schemaType:`boolean`,location:`body`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Exact normalized match against entity brand, legal, or alias names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`featured`,optionKey:`featured`,flag:`--featured [true|false]`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`fundraiseActivity.investedCompanyName`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.investedCountry`,optionKey:`fundraiseInvestedCountry`,flag:`--fundraise-invested-country <fundraise-invested-country...>`,required:!1,description:`Countries of the companies an investor backed, as country names or ids; a deal matches when its company's current headquarters is in one of them. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound or investedIndustry, the same deal must match each.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.investedIndustry`,optionKey:`fundraiseInvestedIndustry`,flag:`--fundraise-invested-industry <fundraise-invested-industry...>`,required:!1,description:`Industry terms for the companies an investor backed, such as Software, Artificial Intelligence, or Fintech; a term matches a portfolio company whose industry or industry classification name contains it as whole words, case-insensitively. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound, the same deal must match both.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.investedRound`,optionKey:`fundraiseInvestedRound`,flag:`--fundraise-invested-round <fundraise-invested-round...>`,required:!1,description:`Round labels of the deals an investor joined, such as Seed, Pre-Seed, or Series A; restricts returned entities to investors with such a deal inside the investment-activity horizon.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.investorName`,optionKey:`fundraiseInvestorName`,flag:`--fundraise-investor-name <fundraise-investor-name...>`,required:!1,description:`Investor names. Exact, case-sensitive match on an investor entity's brand or legal name or an individual investor's full name; restricts returned entities to companies with a fundraise that investor joined.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.rankByInvestmentActivity`,optionKey:`fundraiseRankByInvestmentActivity`,flag:`--fundraise-rank-by-investment-activity [true|false]`,required:!1,description:`True ranks returned investors by recent deal activity ahead of any sort: each deal inside investedRound, investedIndustry, and investedCountry (every deal when all are empty) adds a weight that decays to zero over the investment-activity horizon, nudged by the investor's known USD check. Restricts returned entities to investors with such a deal.`,schemaType:`boolean`,location:`body`},{name:`fundraiseActivity.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`hasFundraising`,optionKey:`hasFundraising`,flag:`--has-fundraising [true|false]`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`headquartersCity`,optionKey:`headquartersCity`,flag:`--headquarters-city <headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`headquartersCountry`,optionKey:`headquartersCountry`,flag:`--headquarters-country <headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`headquartersState`,optionKey:`headquartersState`,flag:`--headquarters-state <headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`industry`,optionKey:`industry`,flag:`--industry <industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`location`,optionKey:`location`,flag:`--location <location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`logoOption.sortPriority`,optionKey:`logoSortPriority`,flag:`--logo-sort-priority <logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`mainProduct`,optionKey:`mainProduct`,flag:`--main-product <main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`operatingStatus`,optionKey:`operatingStatus`,flag:`--operating-status <operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`originCountry`,optionKey:`originCountry`,flag:`--origin-country <origin-country...>`,required:!1,description:`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.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`person`,optionKey:`person`,flag:`--person <person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersCity`,optionKey:`portfolioHeadquartersCity`,flag:`--portfolio-headquarters-city <portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersCountry`,optionKey:`portfolioHeadquartersCountry`,flag:`--portfolio-headquarters-country <portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersState`,optionKey:`portfolioHeadquartersState`,flag:`--portfolio-headquarters-state <portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`qualityGate`,optionKey:`qualityGate`,flag:`--quality-gate <quality-gate>`,required:!1,description:`Server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`rankByProminence`,optionKey:`rankByProminence`,flag:`--rank-by-prominence [true|false]`,required:!1,description:`Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean.`,schemaType:`boolean`,location:`body`},{name:`semanticQuery`,optionKey:`semanticQuery`,flag:`--semantic-query <semantic-query>`,required:!1,description:`Free-text semantic search phrase, this body's query text (there is no query field), such as "AI tools for dental clinics". To find one company by name, send entityName instead. Executable on POST /v1/entities/search; saved views persist it for replay. A semantic page ranks a bounded nearest-neighbor window: totalElements counts the ranked candidates reachable through continuation, not every matching entity.`,schemaType:`string`,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`stage`,optionKey:`stage`,flag:`--stage <stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`suppressLateStage`,optionKey:`suppressLateStage`,flag:`--suppress-late-stage [true|false]`,required:!1,description:`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.`,schemaType:`boolean`,location:`body`},{name:`suppressNonOperating`,optionKey:`suppressNonOperating`,flag:`--suppress-non-operating [true|false]`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`suppressZeroTotalRaised`,optionKey:`suppressZeroTotalRaised`,flag:`--suppress-zero-total-raised [true|false]`,required:!1,description:`Suppress entities with zero or unknown USD total raised.`,schemaType:`boolean`,location:`body`},{name:`tag`,optionKey:`tag`,flag:`--tag <tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`textSearch`,optionKey:`textSearch`,flag:`--text-search <text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`typeCustomer`,optionKey:`typeCustomer`,flag:`--type-customer <type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeModel`,optionKey:`typeModel`,flag:`--type-model <type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeOwnership`,optionKey:`typeOwnership`,flag:`--type-ownership <type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`typeRevenue`,optionKey:`typeRevenue`,flag:`--type-revenue <type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeTechnologyUsed`,optionKey:`typeTechnologyUsed`,flag:`--type-technology-used <type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`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: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Restrict URL matching to one URL type.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index for offset paging; omit it for the first page. Ignored when cursor is sent: to continue a cursor traversal, send the X-Next-Cursor value as cursor and leave page out.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only [true|false]`,required:!1,description:`Return only the matching entity count in totalElements. Content is empty by design, so the page empty flag describes content, not whether matches exist. Unsupported with semanticQuery.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Allow generated monogram logos in results.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque entity cursor; reuse filters and sort. Cursor is unsupported with countOnly; semanticQuery depends on the endpoint.`,schemaType:`string`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`includeFullDetail`,optionKey:`includeFullDetail`,flag:`--include-full-detail [true|false]`,required:!1,description:`Set true to return each match as a company detail search record instead of the list row: the headquarters address, the first 5 people (most recently updated association first), and the first 5 news articles (newest first). Full lists: GET /v1/entities/{entityId}/addresses, GET /v1/entities/{entityId}/people, and GET /v1/news?owner.entityId=.`,schemaType:`boolean`,location:`query`}]},{operationId:`askHelpQuestion`,method:`POST`,path:`/v1/help`,resource:`help`,intent:`search`,cliPath:[`help`,`ask`],summary:`Answer a Natural-Language Platform Help Question`,description:`Answers a question about how to use aVenture, citing the operations it draws on. A question it cannot answer returns LOW confidence instead of a guessed command. With resolve, it returns a recommended operation or workflow, or a clarifying question, instead of a written answer, under its own per-account limit. Free for every signed-in account.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/agent/help-question`,schemaName:`AgentHelpQuestionSchema`,kind:`json`,contentType:`application/json`,description:`A plain-English question about how to use aVenture, answered with references to the operations that do it.`,required:!0,requiredPath:[`question`],parameter:[{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional supported model for the answer. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`question`,optionKey:`question`,flag:`--question <question>`,required:!0,description:`The question to answer, in natural language.`,schemaType:`string`,location:`body`},{name:`resolve`,optionKey:`resolve`,flag:`--resolve [true|false]`,required:!1,description:`True recommends the operation or workflow that does what the question asks, or asks a clarifying question, instead of writing an answer. It ignores model and has its own per-account limit.`,schemaType:`boolean`,location:`body`},{name:`scope`,optionKey:`scope`,flag:`--scope <scope>`,required:!1,description:`Optional scope restricting which operations the answer may recommend; null means all. Allowed values: READ, WRITE, ALL.`,schemaType:`string`,choices:[`READ`,`WRITE`,`ALL`],location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],successResponse:`AgentHelp`,parameters:[]},{operationId:`createLookupJob`,method:`POST`,path:`/v1/lookup-jobs`,resource:`lookup-jobs`,intent:`write`,cliPath:[`lookup-jobs`,`create`],summary:`Start an Article Lookup or a Bounded Lookup-Only Bulk Job`,description:`Without maxNames, reads one article (sourceUrl or sourceNewsId), identifies up to the article limit, and creates a new unpublished record (with its logo and a research request) for a new name only when a second live page also names it. With maxNames, identifies up to that bound from an article or mention names alone, without creating records or requesting research. An article read spends one natural-search slot; accepting a new job spends name-identification slots for its limit. Poll GET /v1/lookup-jobs/{jobId}; the same request sent again soon reuses its paid job.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/lookup/job-mutation`,schemaName:`LookupJobMutationSchema`,kind:`json`,contentType:`application/json`,description:`The article whose companies and people a lookup identifies. Send sourceUrl, sourceNewsId, or both; POST /v1/lookup-mentions also reads a recorded sourceDocumentId alone; lookup-only bulk jobs and POST /v1/lookup-mentions also accept mention instead. A job filed by Prefer: respond-async on GET /v1/lookup or POST /v1/entities/lookup carries that request's subject instead.`,required:!0,requiredPath:[],parameter:[{name:`mention[].name`,optionKey:`mentionName`,flag:`--mention-name <mention-name>`,required:!1,description:`Name as the source writes it.`,schemaType:`string`,location:`body`},{name:`mention[].providerName`,optionKey:`mentionProviderName`,flag:`--mention-provider-name <mention-provider-name>`,required:!1,description:`PRODUCT_SERVICE only: the organization that offers it, as the source writes it. When the offering resolves among offerings and its provider settles on an organization record, the match is limited to that record's offerings.`,schemaType:`string`,location:`body`},{name:`mention[].searchQuery`,optionKey:`mentionSearchQuery`,flag:`--mention-search-query <mention-search-query>`,required:!1,description:`Ignored: the lookup searches by name. Still accepted so callers that send it keep working; omit it.`,schemaType:`string`,location:`body`},{name:`mention[].type`,optionKey:`mentionType`,flag:`--mention-type <mention-type>`,required:!1,description:`Whether the source names a company, a Product or Service (PRODUCT_SERVICE), or a person. A Product or Service resolves like a company first, then among Product and Service records when that finds no match, and never creates a new record. Allowed values: COMPANY, PERSON, PRODUCT_SERVICE.`,schemaType:`string`,choices:[`COMPANY`,`PERSON`,`PRODUCT_SERVICE`],location:`body`},{name:`omitRecords`,optionKey:`omitRecords`,flag:`--omit-records [true|false]`,required:!1,description:`POST /v1/lookup-mentions only: true answers each name with only its name, mentionType, failureReason, and identification status, stage, match, officialUrl, and detail: no entity or person rows and empty candidate and duplicate lists. Defaults to false, the full answer.`,schemaType:`boolean`,location:`body`},{name:`sourceDocumentId`,optionKey:`sourceDocumentId`,flag:`--source-document-id <uuid>`,required:!1,description:`Id of a stored source document whose text is the article; send it alone. Only POST /v1/lookup-mentions reads it, and only for accounts with editing rights.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article; an id that names no stored article is an error.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[{status:`402`,description:`Name identification needs a paid aVenture plan; a caller without one gets 402 with code subscription_required (subscription_canceled, subscription_past_due, or subscription_paused when a plan lapsed).`}],successResponse:`JobEnqueue`,parameters:[{name:`maxNames`,optionKey:`maxNames`,flag:`--max-names <integer>`,required:!1,description:`Opt in to lookup-only bulk; cap is 1 through app.jobs.lookup-job.bulk-mention-limit. Accepts an article or mention names alone; no shells or enrichment are scheduled.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`getLookupJob`,method:`GET`,path:`/v1/lookup-jobs/{jobId}`,resource:`lookup-jobs`,intent:`read`,cliPath:[`lookup-jobs`,`get`],summary:`Get a Lookup Job's State and the Records Its Article Names`,description:`Returns the job state: 202 with Retry-After while PENDING or RUNNING, 200 once terminal. Once COMPLETED, it returns each identified name: MATCHED names the stored record, NEEDS_REVIEW lists candidates, and a failed name carries failureReason. Ordinary article jobs may include shell, enrichmentRunId, or shellDetail on NO_MATCH. Bulk jobs return maxNames and limitReached; reaching the bound means more names may remain. A single-subject job, filed by Prefer: respond-async on GET or POST /v1/lookup or POST /v1/entities/lookup, or by a signed-in live lookup on those routes that rolled over to a job, carries source.subject and, once COMPLETED, identification: the answer that route returns. Only the requesting caller can read the job.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`LookupJob`,parameters:[{name:`jobId`,optionKey:`jobId`,flag:`--job-id <uuid>`,required:!0,description:`Lookup job id from the create response.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getNews`,method:`GET`,path:`/v1/news/{newsId}`,resource:`news`,intent:`read`,cliPath:[`news`,`get`],summary:`Get One News Article`,description:`Returns news detail by exact positive ID. Use lookup for a slug, external ID, URL, or title candidates.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`NewsDetail`,parameters:[{name:`newsId`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!0,description:`Exact positive news article id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listNews`,method:`GET`,path:`/v1/news`,resource:`news`,intent:`read`,cliPath:[`news`,`list`],summary:`List News Articles, Including a Company's or Person's News`,description:`Browse news articles in the canonical news domain, with optional filtering. A company's news is this list filtered by owner.entityId (CLI --owner-entity-id); a person's by owner.personId (CLI --owner-person-id). This is the article list: the entities an article is about come from the semantic-similarity read, not here.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`News`,parameters:[{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned; default and maximum 25 for the standard list, where larger values are reduced to that maximum. Entity, person, author-initial, and thin-mode reads accept larger pages.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Full-text news search term.`,schemaType:`string`,location:`query`},{name:`category`,optionKey:`category`,flag:`--category <category>`,required:!1,description:`News category slug to include or exclude.`,schemaType:`string`,location:`query`},{name:`owner.entityId`,optionKey:`ownerEntityId`,flag:`--owner-entity-id <uuid>`,required:!1,description:`Owning entity id; set only when personId is absent.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`owner.personId`,optionKey:`ownerPersonId`,flag:`--owner-person-id <uuid>`,required:!1,description:`Owning person id; set only when entityId is absent.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`excludeId`,optionKey:`excludeId`,flag:`--exclude-id <integer>`,required:!1,description:`Exclude one news article by id.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`publishedAfter`,optionKey:`publishedAfter`,flag:`--published-after <date>`,required:!1,description:`Earliest publication date, inclusive.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`publishedBefore`,optionKey:`publishedBefore`,flag:`--published-before <date>`,required:!1,description:`Latest publication date, inclusive.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`lookupNews`,method:`GET`,path:`/v1/news/lookup`,resource:`news`,intent:`lookup`,cliPath:[`news`,`lookup`],summary:`Look Up One News Article`,description:`Resolves news detail by slug, external ID, URL, or bounded title candidate signals. Use the numeric item route for an id; any id query is rejected. Canonical redirects are preserved.`,scope:`read`,auth:`bearer`,errorResponse:[{status:`409`,description:`Ambiguous candidate signals: more than one article still matches the supplied title/URL bundle. ProblemDetail carries details.newsCandidate; review those ids, update the matching article, and create only when all candidates are distinct and source evidence supports the target. score and threshold are review ranking, not absence proof. Resolve directly by id, slug, or externalId.`}],successResponse:`NewsDetail`,parameters:[{name:`slug`,optionKey:`newsSlug`,flag:`--news-slug <news-slug>`,required:!1,description:`Exact news article slug (URL-friendly identifier). Mutually exclusive with id, externalId, url, and title.`,schemaType:`string`,location:`query`},{name:`externalId`,optionKey:`externalId`,flag:`--external-id <external-id>`,required:!1,description:`External ID or RSS GUID for ingestion-key lookup. Mutually exclusive with id, slug, url, and title.`,schemaType:`string`,location:`query`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Original article URL to resolve via strict host+path or domain-only match. Mutually exclusive with id, slug, and externalId. May pair with title and publication to narrow candidate recovery after an exact URL miss. Pair with urlMatchMode to disambiguate.`,schemaType:`string`,location:`query`},{name:`title`,optionKey:`title`,flag:`--title <title>`,required:!1,description:`Candidate lookup signal: article title. Mutually exclusive with id, slug, and externalId. Combine with publication, urlDomain, or url for bounded candidate search.`,schemaType:`string`,location:`query`},{name:`publication`,optionKey:`publication`,flag:`--publication <publication>`,required:!1,description:`Publication qualifier (e.g., 'TechCrunch', 'Forbes'). Narrows a title candidate search. Not an identifier on its own.`,schemaType:`string`,location:`query`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Candidate lookup URL domain qualifier (host only, no path). Narrows a title candidate search. Not an identifier on its own.`,schemaType:`string`,location:`query`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL match mode qualifier: 'hostPath' (strict host + path match, default) or 'domain' (host-only match). Narrows url and urlDomain matching. Not an identifier on its own.`,schemaType:`string`,location:`query`}]},{operationId:`getPerson`,method:`GET`,path:`/v1/people/{personId}`,resource:`people`,intent:`read`,cliPath:[`people`,`get`],summary:`Get One Person by ID`,description:`Returns person 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.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`PersonDetail`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Exact person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url [true|false]`,required:!1,description:`Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array.`,schemaType:`boolean`,location:`query`},{name:`includeAssociation`,optionKey:`includeAssociation`,flag:`--include-association [true|false]`,required:!1,description:`Projection qualifier — include association values (default: true). Set false to omit association array.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address [true|false]`,required:!1,description:`Projection qualifier — include address values (default: true). Set false to omit address array.`,schemaType:`boolean`,location:`query`},{name:`maxAssociations`,optionKey:`maxAssociations`,flag:`--max-associations <integer>`,required:!1,description:`Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response.`,schemaType:`boolean`,location:`query`},{name:`include`,optionKey:`include`,flag:`--include <include...>`,required:!1,description:`Projection qualifier — profile panels to embed in this one read (repeat or comma-separate). Each named panel answers the same rows as its own endpoint's first page; omitted panels stay absent. Allowed values: graph, investorActivity, similar, blogPost, investment.`,schemaType:`array`,itemSchemaType:`string`,choices:[`graph`,`investorActivity`,`similar`,`blogPost`,`investment`],location:`query`}]},{operationId:`listPeople`,method:`GET`,path:`/v1/people`,resource:`people`,intent:`read`,cliPath:[`people`,`list`],summary:`List People`,description:`List people with the same filters and sort as POST /v1/people/search, passed as query parameters. Use the POST search for semantic ranking or a JSON body, and POST /v1/search/natural/people for plain English.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`Person`,parameters:[{name:`firstName`,optionKey:`firstName`,flag:`--first-name <first-name>`,required:!1,description:`Person first name.`,schemaType:`string`,location:`query`},{name:`lastName`,optionKey:`lastName`,flag:`--last-name <last-name>`,required:!1,description:`Person last name.`,schemaType:`string`,location:`query`},{name:`status`,optionKey:`status`,flag:`--status <status>`,required:!1,description:`Person workflow status.`,schemaType:`string`,location:`query`},{name:`arrayFilter.entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Associated entity names.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`arrayFilter.typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Associated entity type scope. Omit or use [] for any associated type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`query`},{name:`arrayFilter.personTitle`,optionKey:`personTitle`,flag:`--person-title <person-title...>`,required:!1,description:`Person titles.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`arrayFilter.investedCompany`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Invested company names.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`arrayFilter.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`arrayFilter.amountRaisedRange[0].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`arrayFilter.amountRaisedRange[0].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`arrayFilter.amountInvestedRange[0].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`arrayFilter.amountInvestedRange[0].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`arrayFilter.totalInvestmentCount[0].min`,optionKey:`totalInvestmentCountMin`,flag:`--total-investment-count-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`arrayFilter.totalInvestmentCount[0].max`,optionKey:`totalInvestmentCountMax`,flag:`--total-investment-count-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`,location:`query`},{name:`personName`,optionKey:`personName`,flag:`--person-name <person-name...>`,required:!1,description:`Exact normalized match against a person's full name or slug.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Restrict results to specific person IDs. Omit or use [] for no ID restriction.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First-name initial.`,schemaType:`string`,location:`query`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Associated entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`entitySlug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Associated entity slug.`,schemaType:`string`,location:`query`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Associated entity role or title.`,schemaType:`string`,location:`query`},{name:`isCurrent`,optionKey:`isCurrent`,flag:`--is-current [true|false]`,required:!1,description:`Filter current associations.`,schemaType:`boolean`,location:`query`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url [true|false]`,required:!1,description:`Include URL links on each person.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address [true|false]`,required:!1,description:`Include addresses on each person.`,schemaType:`boolean`,location:`query`},{name:`investorActivity.totalInvestmentRange[0].min`,optionKey:`investorActivityTotalInvestmentRangeMin`,flag:`--investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`investorActivity.totalInvestmentRange[0].max`,optionKey:`investorActivityTotalInvestmentRangeMax`,flag:`--investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`investorActivity.totalAmountInvestedUsdRange[0].min`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMin`,flag:`--investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.totalAmountInvestedUsdRange[0].max`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMax`,flag:`--investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.averageAmountInvestedUsdRange[0].min`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMin`,flag:`--investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.averageAmountInvestedUsdRange[0].max`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMax`,flag:`--investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.largestAmountInvestedUsdRange[0].min`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMin`,flag:`--investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.largestAmountInvestedUsdRange[0].max`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMax`,flag:`--investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.smallestAmountInvestedUsdRange[0].min`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`investorActivity.smallestAmountInvestedUsdRange[0].max`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`query`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only [true|false]`,required:!1,description:`When true, return only the page total in the body and skip the content payload.`,schemaType:`boolean`,location:`query`},{name:`hasImageFirst`,optionKey:`hasImageFirst`,flag:`--has-image-first [true|false]`,required:!1,description:`When true, sort people who have a photo before those who do not.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`When false, monogram fallback logos are stripped from the response. Defaults to true.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`lookupPerson`,method:`POST`,path:`/v1/people/lookup`,resource:`people`,intent:`lookup`,cliPath:[`people`,`lookup`],summary:`Deprecated: Find Which Person a Name Refers to, or Confirm They Are New`,description:`Deprecated: send the same body to lookup-from-file (POST /v1/lookup) with kind PERSON. Identifies which person a name refers to among the records you can see, and returns status MATCHED, NO_MATCH, or NEEDS_REVIEW. MATCHED: match.owner.personId is the person; read them with GET /v1/people/{personId} or queue research on them with POST /v1/people/{personId}/enrichments. NO_MATCH: no record you can see is this person. NEEDS_REVIEW: several candidates fit; resend with the person's LinkedIn or personal URL, and employer and title as context, to settle it. stage names the step that settled the answer: DETERMINISTIC (URL proof, no model call), JUDGMENT (a model review), or WEB_EVIDENCE (added a web search). The same name at a different employer is a different person. For full detail by exact slug or URL use GET /v1/people/lookup-exact. Example body: {"name":"Jane Doe","context":"CEO at Acme AI"}.`,deprecated:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/identification/subject`,schemaName:`IdentificationSubjectSchema`,kind:`json`,contentType:`application/json`,description:`The company, Product, Service, or person to identify. Send the name, a URL it owns, or both, plus every location and source you have; a website or profile URL usually settles the answer without any model call.`,required:!0,requiredPath:[],parameter:[{name:`context`,optionKey:`context`,flag:`--context <context>`,required:!1,description:`Specific facts in plain words: product, industry, employer and title, or founder names. Generic words like startup add nothing.`,schemaType:`string`,location:`body`},{name:`kind`,optionKey:`kind`,flag:`--kind <kind>`,required:!1,description:`Kind of record to identify when you know it: ENTITY for companies, funds, and firms (and their products or services); PERSON for people. Only that kind is looked up; typeRecord or providerId implies ENTITY. Allowed values: ENTITY, PERSON.`,schemaType:`string`,choices:[`ENTITY`,`PERSON`],location:`body`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own.`,schemaType:`string`,location:`body`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!1,description:`Name exactly as the source writes it, such as Acme AI or Jane Doe. Send name, url, or both; a name that is an absolute http(s) URL is read as url.`,schemaType:`string`,location:`body`},{name:`providerId`,optionKey:`providerId`,flag:`--provider-id <uuid>`,required:!1,description:`Provider entity id for a Product or Service lookup. Omit it when the provider is unknown. With no typeRecord, searches both Product and Service. Invalid for a company type or a person lookup.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`sourceIdentifier.idType`,optionKey:`sourceIdentifierIdType`,flag:`--source-identifier-id-type <source-identifier-id-type>`,required:!1,description:`Identifier type token, for example ein, secCik, or ticker.`,schemaType:`string`,location:`body`},{name:`sourceIdentifier.identifier`,optionKey:`sourceIdentifierIdentifier`,flag:`--source-identifier-identifier <source-identifier-identifier>`,required:!1,description:`Identifier value as issued by the registry.`,schemaType:`string`,location:`body`},{name:`sourceIdentifier.source`,optionKey:`sourceIdentifierSource`,flag:`--source-identifier-source <source-identifier-source>`,required:!1,description:`Optional attribution source label for the mapping.`,schemaType:`string`,location:`body`},{name:`sourceNewsId`,optionKey:`sourceNewsId`,flag:`--source-news-id <integer>`,required:!1,description:`aVenture news id of the article that mentions the subject; an unknown id is a 400.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`sourceUrl`,optionKey:`sourceUrl`,flag:`--source-url <source-url>`,required:!1,description:`URL of the article that mentions the subject; read from aVenture news when stored there, otherwise fetched.`,schemaType:`string`,location:`body`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Entity type to identify. A Product or Service never matches its provider organization, but a record stored under a neighboring type of the same family (Product or Service; Fund, Investment Firm, or Company) still matches, and a Business Line lookup sees both families. Invalid for a person lookup. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`URLs the subject owns: its website, its LinkedIn company or person profile, an aVenture page, or a registry page. At most 10. Required when name is omitted. Put articles in sourceUrl.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`Name identification needs a paid aVenture plan; a caller without one gets 402 with code subscription_required (subscription_canceled, subscription_past_due, or subscription_paused when a plan lapsed).`}],successResponse:`Identification`,parameters:[{name:`scheduleEnrichment`,optionKey:`scheduleEnrichment`,flag:`--schedule-enrichment [true|false]`,required:!1,description:`For an existing match, set true to queue research on it; omitted or false does not. A record this lookup adds is not researched; request research on it with POST /v1/research-runs.`,schemaType:`boolean`,location:`query`}]},{operationId:`lookupPersonBatch`,method:`POST`,path:`/v1/people/lookup-batch`,resource:`people`,intent:`lookup`,cliPath:[`people`,`lookup-batch`],summary:`Look Up People in Bulk by ID or Slug`,description:`Enrich multiple people by id or slug with optional url, association, and address. When page and size are omitted, the full deduplicated batch is returned in request order. Sort is not supported for this fixed-order batch response. 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.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/lookup-batch`,schemaName:`PersonLookupBatchSchema`,kind:`json`,contentType:`application/json`,description:`Batch request for person detail enrichment. Each selector array accepts at most 200 values, and at most 200 selectors may be submitted across personId, slug, and url.`,required:!1,requiredPath:[],parameter:[{name:`hasImageFirst`,optionKey:`hasImageFirst`,flag:`--has-image-first [true|false]`,required:!1,description:`Sort results by image presence.`,schemaType:`boolean`,defaultValue:!1,location:`body`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address [true|false]`,required:!1,description:`Include address values.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`includeAssociation`,optionKey:`includeAssociation`,flag:`--include-association [true|false]`,required:!1,description:`Include association values.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url [true|false]`,required:!1,description:`Include URL links.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`maxAssociations`,optionKey:`maxAssociations`,flag:`--max-associations <integer>`,required:!1,description:`Max association values per person.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`40`,location:`body`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit monogram fallbacks.`,schemaType:`boolean`,defaultValue:!0,location:`body`},{name:`personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Person UUID values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Person slug values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url...>`,required:!1,description:`Person URL values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],successResponse:`PersonDetail`,parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N); omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned; omit page and size for the full batch.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`searchPeople`,method:`POST`,path:`/v1/people/search`,resource:`people`,intent:`search`,cliPath:[`people`,`search`],summary:`Search People`,description:`Browse, filter, and search person, people, and individual records in the people domain; returns a paginated people list matching a filter request body. semanticQuery uses the live priority embeddings tier and returns semanticMatch evidence. Without semanticQuery or search, a default-sorted page emits an X-Next-Cursor keyset continuation; send it back as cursor, without sort, to read the next page.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/filter`,schemaName:`PersonFilterSchema`,kind:`json`,contentType:`application/json`,description:`Canonical person criteria contract for GET/POST/batch endpoints`,required:!1,requiredPath:[],parameter:[{name:`arrayFilter.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`arrayFilter.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`arrayFilter.totalInvestmentCount[].min`,optionKey:`totalInvestmentCountMin`,flag:`--total-investment-count-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.employeeCountRange[].min`,optionKey:`entityFilterEmployeeCountRangeMin`,flag:`--entity-filter-employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.amountInvestedRange[].min`,optionKey:`entityFilterFundraiseAmountInvestedRangeMin`,flag:`--entity-filter-fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.amountRaisedRange[].min`,optionKey:`entityFilterFundraiseAmountRaisedRangeMin`,flag:`--entity-filter-fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.dateAnnouncedRange.min`,optionKey:`entityFilterFundraiseDateAnnouncedRangeMin`,flag:`--entity-filter-fundraise-date-announced-range-min <date-time>`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--entity-filter-fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.lastRoundYearRange[].min`,optionKey:`entityFilterFundraiseLastRoundYearRangeMin`,flag:`--entity-filter-fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.totalRaisedRange[].min`,optionKey:`entityFilterFundraiseTotalRaisedRangeMin`,flag:`--entity-filter-fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.valuationRange[].min`,optionKey:`entityFilterFundraiseValuationRangeMin`,flag:`--entity-filter-fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.yearFoundedRange[].min`,optionKey:`entityFilterYearFoundedRangeMin`,flag:`--entity-filter-year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMin`,flag:`--investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMin`,flag:`--investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMin`,flag:`--investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.totalInvestmentRange[].min`,optionKey:`investorActivityTotalInvestmentRangeMin`,flag:`--investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`arrayFilter.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`arrayFilter.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`arrayFilter.totalInvestmentCount[].max`,optionKey:`totalInvestmentCountMax`,flag:`--total-investment-count-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.employeeCountRange[].max`,optionKey:`entityFilterEmployeeCountRangeMax`,flag:`--entity-filter-employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.amountInvestedRange[].max`,optionKey:`entityFilterFundraiseAmountInvestedRangeMax`,flag:`--entity-filter-fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.amountRaisedRange[].max`,optionKey:`entityFilterFundraiseAmountRaisedRangeMax`,flag:`--entity-filter-fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.dateAnnouncedRange.max`,optionKey:`entityFilterFundraiseDateAnnouncedRangeMax`,flag:`--entity-filter-fundraise-date-announced-range-max <date-time>`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--entity-filter-fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.lastRoundYearRange[].max`,optionKey:`entityFilterFundraiseLastRoundYearRangeMax`,flag:`--entity-filter-fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`entityFilter.fundraiseActivity.totalRaisedRange[].max`,optionKey:`entityFilterFundraiseTotalRaisedRangeMax`,flag:`--entity-filter-fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.fundraiseActivity.valuationRange[].max`,optionKey:`entityFilterFundraiseValuationRangeMax`,flag:`--entity-filter-fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`entityFilter.yearFoundedRange[].max`,optionKey:`entityFilterYearFoundedRangeMax`,flag:`--entity-filter-year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMax`,flag:`--investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMax`,flag:`--investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMax`,flag:`--investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`investorActivity.totalInvestmentRange[].max`,optionKey:`investorActivityTotalInvestmentRangeMax`,flag:`--investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`arrayFilter.entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Associated entity names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`arrayFilter.investedCompany`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Invested company names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`arrayFilter.personTitle`,optionKey:`personTitle`,flag:`--person-title <person-title...>`,required:!1,description:`Person titles.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`arrayFilter.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`arrayFilter.typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Associated entity type scope. Omit or use [] for any associated type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`entityFilter.acceleratorBrand`,optionKey:`entityFilterAcceleratorBrand`,flag:`--entity-filter-accelerator-brand <entity-filter-accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.acceleratorCohort`,optionKey:`entityFilterAcceleratorCohort`,flag:`--entity-filter-accelerator-cohort <entity-filter-accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.acceleratorName`,optionKey:`entityFilterAcceleratorName`,flag:`--entity-filter-accelerator-name <entity-filter-accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.acceleratorStatus`,optionKey:`entityFilterAcceleratorStatus`,flag:`--entity-filter-accelerator-status <entity-filter-accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.affinity`,optionKey:`entityFilterAffinity`,flag:`--entity-filter-affinity <entity-filter-affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.closedLast`,optionKey:`entityFilterClosedLast`,flag:`--entity-filter-closed-last [true|false]`,required:!1,description:`Rank closed entities (Closed, Closed (Acquihire), Inactive) after every other textSearch or semanticQuery match, ahead of relevance and sort; omitted means true. false ranks them by relevance alone. Filter them out with operatingStatus or suppressNonOperating.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.entityId`,optionKey:`entityFilterEntityId`,flag:`--entity-filter-entity-id <entity-filter-entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.entityName`,optionKey:`entityFilterEntityName`,flag:`--entity-filter-entity-name <entity-filter-entity-name...>`,required:!1,description:`Exact normalized match against entity brand, legal, or alias names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.featured`,optionKey:`entityFilterFeatured`,flag:`--entity-filter-featured [true|false]`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.fundraiseActivity.investedCompanyName`,optionKey:`entityFilterFundraiseInvestedCompanyName`,flag:`--entity-filter-fundraise-invested-company-name <entity-filter-fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.fundraiseActivity.investedCountry`,optionKey:`entityFilterFundraiseInvestedCountry`,flag:`--entity-filter-fundraise-invested-country <entity-filter-fundraise-invested-country...>`,required:!1,description:`Countries of the companies an investor backed, as country names or ids; a deal matches when its company's current headquarters is in one of them. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound or investedIndustry, the same deal must match each.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.fundraiseActivity.investedIndustry`,optionKey:`entityFilterFundraiseInvestedIndustry`,flag:`--entity-filter-fundraise-invested-industry <entity-filter-fundraise-invested-industry...>`,required:!1,description:`Industry terms for the companies an investor backed, such as Software, Artificial Intelligence, or Fintech; a term matches a portfolio company whose industry or industry classification name contains it as whole words, case-insensitively. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound, the same deal must match both.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.fundraiseActivity.investedRound`,optionKey:`entityFilterFundraiseInvestedRound`,flag:`--entity-filter-fundraise-invested-round <entity-filter-fundraise-invested-round...>`,required:!1,description:`Round labels of the deals an investor joined, such as Seed, Pre-Seed, or Series A; restricts returned entities to investors with such a deal inside the investment-activity horizon.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.fundraiseActivity.investorName`,optionKey:`entityFilterFundraiseInvestorName`,flag:`--entity-filter-fundraise-investor-name <entity-filter-fundraise-investor-name...>`,required:!1,description:`Investor names. Exact, case-sensitive match on an investor entity's brand or legal name or an individual investor's full name; restricts returned entities to companies with a fundraise that investor joined.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.fundraiseActivity.rankByInvestmentActivity`,optionKey:`entityFilterFundraiseRankByInvestmentActivity`,flag:`--entity-filter-fundraise-rank-by-investment-activity [true|false]`,required:!1,description:`True ranks returned investors by recent deal activity ahead of any sort: each deal inside investedRound, investedIndustry, and investedCountry (every deal when all are empty) adds a weight that decays to zero over the investment-activity horizon, nudged by the investor's known USD check. Restricts returned entities to investors with such a deal.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.fundraiseActivity.round`,optionKey:`entityFilterFundraiseRound`,flag:`--entity-filter-fundraise-round <entity-filter-fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.hasFundraising`,optionKey:`entityFilterHasFundraising`,flag:`--entity-filter-has-fundraising [true|false]`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.headquartersCity`,optionKey:`entityFilterHeadquartersCity`,flag:`--entity-filter-headquarters-city <entity-filter-headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.headquartersCountry`,optionKey:`entityFilterHeadquartersCountry`,flag:`--entity-filter-headquarters-country <entity-filter-headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.headquartersState`,optionKey:`entityFilterHeadquartersState`,flag:`--entity-filter-headquarters-state <entity-filter-headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.industry`,optionKey:`entityFilterIndustry`,flag:`--entity-filter-industry <entity-filter-industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.letter`,optionKey:`entityFilterLetter`,flag:`--entity-filter-letter <entity-filter-letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`entityFilter.location`,optionKey:`entityFilterLocation`,flag:`--entity-filter-location <entity-filter-location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.logoOption.sortPriority`,optionKey:`entityFilterLogoSortPriority`,flag:`--entity-filter-logo-sort-priority <entity-filter-logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`entityFilter.mainProduct`,optionKey:`entityFilterMainProduct`,flag:`--entity-filter-main-product <entity-filter-main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.operatingStatus`,optionKey:`entityFilterOperatingStatus`,flag:`--entity-filter-operating-status <entity-filter-operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`entityFilter.originCountry`,optionKey:`entityFilterOriginCountry`,flag:`--entity-filter-origin-country <entity-filter-origin-country...>`,required:!1,description:`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.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.person`,optionKey:`entityFilterPerson`,flag:`--entity-filter-person <entity-filter-person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.portfolioHeadquartersCity`,optionKey:`entityFilterPortfolioHeadquartersCity`,flag:`--entity-filter-portfolio-headquarters-city <entity-filter-portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.portfolioHeadquartersCountry`,optionKey:`entityFilterPortfolioHeadquartersCountry`,flag:`--entity-filter-portfolio-headquarters-country <entity-filter-portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.portfolioHeadquartersState`,optionKey:`entityFilterPortfolioHeadquartersState`,flag:`--entity-filter-portfolio-headquarters-state <entity-filter-portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.qualityGate`,optionKey:`entityFilterQualityGate`,flag:`--entity-filter-quality-gate <entity-filter-quality-gate>`,required:!1,description:`Server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`entityFilter.rankByProminence`,optionKey:`entityFilterRankByProminence`,flag:`--entity-filter-rank-by-prominence [true|false]`,required:!1,description:`Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.slug`,optionKey:`entityFilterSlug`,flag:`--entity-filter-slug <entity-filter-slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.stage`,optionKey:`entityFilterStage`,flag:`--entity-filter-stage <entity-filter-stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.suppressLateStage`,optionKey:`entityFilterSuppressLateStage`,flag:`--entity-filter-suppress-late-stage [true|false]`,required:!1,description:`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.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.suppressNonOperating`,optionKey:`entityFilterSuppressNonOperating`,flag:`--entity-filter-suppress-non-operating [true|false]`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.suppressZeroTotalRaised`,optionKey:`entityFilterSuppressZeroTotalRaised`,flag:`--entity-filter-suppress-zero-total-raised [true|false]`,required:!1,description:`Suppress entities with zero or unknown USD total raised.`,schemaType:`boolean`,location:`body`},{name:`entityFilter.tag`,optionKey:`entityFilterTag`,flag:`--entity-filter-tag <entity-filter-tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.textSearch`,optionKey:`entityFilterTextSearch`,flag:`--entity-filter-text-search <entity-filter-text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`entityFilter.typeCustomer`,optionKey:`entityFilterTypeCustomer`,flag:`--entity-filter-type-customer <entity-filter-type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.typeModel`,optionKey:`entityFilterTypeModel`,flag:`--entity-filter-type-model <entity-filter-type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.typeOwnership`,optionKey:`entityFilterTypeOwnership`,flag:`--entity-filter-type-ownership <entity-filter-type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.typeRecord`,optionKey:`entityFilterTypeRecord`,flag:`--entity-filter-type-record <entity-filter-type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`entityFilter.typeRevenue`,optionKey:`entityFilterTypeRevenue`,flag:`--entity-filter-type-revenue <entity-filter-type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.typeTechnologyUsed`,optionKey:`entityFilterTypeTechnologyUsed`,flag:`--entity-filter-type-technology-used <entity-filter-type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityFilter.url`,optionKey:`entityFilterUrl`,flag:`--entity-filter-url <entity-filter-url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`entityFilter.urlDomain`,optionKey:`entityFilterUrlDomain`,flag:`--entity-filter-url-domain <entity-filter-url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`entityFilter.urlMatchMode`,optionKey:`entityFilterUrlMatchMode`,flag:`--entity-filter-url-match-mode <entity-filter-url-match-mode>`,required:!1,description:`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: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`entityFilter.urlType`,optionKey:`entityFilterUrlType`,flag:`--entity-filter-url-type <entity-filter-url-type>`,required:!1,description:`Restrict URL matching to one URL type.`,schemaType:`string`,location:`body`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Associated entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`entitySlug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Associated entity slug.`,schemaType:`string`,location:`body`},{name:`firstName`,optionKey:`firstName`,flag:`--first-name <first-name>`,required:!1,description:`Person first name.`,schemaType:`string`,location:`body`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address [true|false]`,required:!1,description:`Include addresses on each person.`,schemaType:`boolean`,location:`body`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url [true|false]`,required:!1,description:`Include URL links on each person.`,schemaType:`boolean`,location:`body`},{name:`isCurrent`,optionKey:`isCurrent`,flag:`--is-current [true|false]`,required:!1,description:`Filter current associations.`,schemaType:`boolean`,location:`body`},{name:`lastName`,optionKey:`lastName`,flag:`--last-name <last-name>`,required:!1,description:`Person last name.`,schemaType:`string`,location:`body`},{name:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First-name initial.`,schemaType:`string`,location:`body`},{name:`personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Restrict results to specific person IDs. Omit or use [] for no ID restriction.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`personName`,optionKey:`personName`,flag:`--person-name <person-name...>`,required:!1,description:`Exact normalized match against a person's full name or slug.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Associated entity role or title.`,schemaType:`string`,location:`body`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`,location:`body`},{name:`semanticQuery`,optionKey:`semanticQuery`,flag:`--semantic-query <semantic-query>`,required:!1,description:`Semantic person search phrase. A semantic page ranks a bounded nearest-neighbor window: totalElements counts the ranked candidates reachable through continuation, not every matching person.`,schemaType:`string`,location:`body`},{name:`status`,optionKey:`status`,flag:`--status <status>`,required:!1,description:`Person workflow status.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],successResponse:`Person`,parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index for offset paging; omit it for the first page. Ignored when cursor is sent: to continue a cursor traversal, send the X-Next-Cursor value as cursor and leave page out.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only [true|false]`,required:!1,description:`When true, return only the page total in the body and skip the content payload.`,schemaType:`boolean`,location:`query`},{name:`hasImageFirst`,optionKey:`hasImageFirst`,flag:`--has-image-first [true|false]`,required:!1,description:`When true, sort people who have a photo before those who do not.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`When false, monogram fallback logos are stripped from the response. Defaults to true.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque continuation from X-Next-Cursor. Repeat the same filters and size; a semantic cursor also repeats sort, a keyset cursor omits it.`,schemaType:`string`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`createResearchRun`,method:`POST`,path:`/v1/research-runs`,resource:`research-runs`,intent:`write`,cliPath:[`research-runs`,`create`],summary:`Research a Company or Person by URL`,description:"Files a research request for the company, Product, Service, or person at url and returns the run, owned by you. Send name when known. A url an existing profile owns refreshes that profile; any other url researches a new one, so this is how to add a subject that POST /v1/lookup answers NO_MATCH. A new run reserves one `company` or `person` research unit, spent only once the run saves research and returned when it ends without any. Your own queued or running run for the same subject, mode, and presets is returned instead, uncharged. A record is researched at most once per rolling 24 hours across all callers: while it is already being researched, or when research on it completed inside that window, nothing is filed or charged and the request answers 429 whose detail says when to retry. A url that matches more than one record answers 409, and a spent allowance answers 429. You may set only url, name, model, mode, userPrompt, taskPresetKey, and finding; any other field is refused with 403, and a userPrompt longer than 2000 characters is refused with 400. Follow progress with GET /v1/research-runs/{runId}; you are notified when the run completes.",requestBody:[{schemaImport:`@aventurevc/api-schemas/harness/run-create`,schemaName:`HarnessRunCreateSchema`,kind:`json`,contentType:`application/json`,description:`Request one research run`,required:!0,requiredPath:[`url`],parameter:[{name:`finding[].gateId`,optionKey:`findingGateId`,flag:`--finding-gate-id <finding-gate-id>`,required:!1,description:`Profile field the fact fills, when known; omit it and the run picks the field the fact belongs to.`,schemaType:`string`,location:`body`},{name:`finding[].quote`,optionKey:`findingQuote`,flag:`--finding-quote <finding-quote>`,required:!1,description:`The exact text on sourceUrl that states the fact, copied verbatim; a fragment short enough to appear on any page is refused.`,schemaType:`string`,location:`body`},{name:`finding[].sourceUrl`,optionKey:`findingSourceUrl`,flag:`--finding-source-url <finding-source-url>`,required:!1,description:`Absolute http or https URL of the page that supports the fact; aVenture pages are refused.`,schemaType:`string`,location:`body`},{name:`finding[].statement`,optionKey:`findingStatement`,flag:`--finding-statement <finding-statement>`,required:!1,description:`The fact to write, in plain words.`,schemaType:`string`,location:`body`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:`How broadly the run researches the subject; omit it for COMPREHENSIVE. Allowed values: COMPREHENSIVE, INDIVIDUAL.`,schemaType:`string`,choices:[`COMPREHENSIVE`,`INDIVIDUAL`],location:`body`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Model id the run uses; omit it to use the default model.`,schemaType:`string`,location:`body`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!1,description:`Name of the subject at url, such as Clarity Health; the run verifies it and uses it to pick the right subject when the site names several.`,schemaType:`string`,location:`body`},{name:`taskPresetKey`,optionKey:`taskPresetKey`,flag:`--task-preset-key <task-preset-key...>`,required:!1,description:`Research presets that focus the run, listed by GET /v1/research-runs/presets; omit them for a full run.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!0,description:`Official website or profile URL of the company, Product, Service, or person to research; a URL no current record owns researches a new one.`,schemaType:`string`,location:`body`},{name:`userPrompt`,optionKey:`userPrompt`,flag:`--user-prompt <user-prompt>`,required:!1,description:`Optional steering prompt.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[{status:`402`,description:`Needs a plan that includes research runs; a caller without one gets 402 with code subscription_required (subscription_canceled, subscription_past_due, or subscription_paused when a plan lapsed).`}],successResponse:`HarnessRun`,detailField:[`chassis`,`chassisRouted`,`hasSourceDocument`,`lane`,`latestStatus`,`llmApi`,`maxScoutConcurrent`,`nextAttemptAt`,`subagentModel`,`taskPresetKey`,`updatedAt`],parameters:[]},{operationId:`getResearchRun`,method:`GET`,path:`/v1/research-runs/{runId}`,resource:`research-runs`,intent:`read`,cliPath:[`research-runs`,`get`],summary:`Get One Research Run`,description:`Returns one of your research runs with its status, latest progress, and, once available, the resulting profile and its public URL.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`HarnessRunDetail`,detailField:[`run.chassis`,`run.chassisRouted`,`run.hasSourceDocument`,`run.lane`,`run.latestStatus`,`run.llmApi`,`run.maxScoutConcurrent`,`run.nextAttemptAt`,`run.subagentModel`,`run.taskPresetKey`,`run.updatedAt`],parameters:[{name:`runId`,optionKey:`runId`,flag:`--run-id <uuid>`,required:!0,description:`Research run id.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getResolvedHandle`,method:`GET`,path:`/v1/resolve/{token}`,resource:`resolve`,intent:`read`,cliPath:[`resolve`,`get`],summary:`Deprecated: Resolve an Entity or Person by Identifier Token`,description:`Deprecated: use POST /v1/lookup?legacy=true with body {"name":"<token>"}. Resolve any identifier token to its canonical entity or person. Tries UUID, then the stable public handle, then external registry ids, then the slug (with redirects). Returns 404 when nothing matches and 409 when an external id maps to multiple owners. A name or website URL is not a token; resolve it with the entity or person lookup.`,deprecated:!0,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`ResolvedHandle`,parameters:[{name:`token`,optionKey:`token`,flag:`--token <token>`,required:!0,description:`Any identifier: a stable public handle (e.g. eV1StGXR8Z5a), a UUID, an external registry id (ticker, LEI, EIN, ...), or a slug.`,schemaType:`string`,location:`path`}]},{operationId:`searchLink`,method:`GET`,path:`/v1/search/link`,resource:`search`,intent:`search`,cliPath:[`search`,`link`],summary:`Search From a Page URL`,description:"Fetches the page at the supplied URL, identifies the single company, product, or person the page is primarily about, and returns the federated entity, person, and news results for that name together with the synthesized query itself. A page whose content cannot be read returns 404; a fetch or inference failure returns a problem (503 only when a retry can succeed), never an empty result. For direct URL-to-record identity resolution use the entities lookup operation with the url instead. Send `Prefer: respond-async` to skip the live wait: the search is committed as a link search job and the read answers 202 with a Location status URL and Retry-After; poll it. A repeat of a search that completed in the last few minutes answers 200 from its stored result. A failed job commit answers 503; a caller already holding the maximum active link searches gets 429.",scope:`read`,auth:`bearer`,errorResponse:[{status:`402`,description:`This search needs a paid aVenture plan; a caller without one gets 402 with code subscription_required.`}],successResponse:`LinkSearch`,parameters:[{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!0,description:`Public article or page URL to search from.`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`Prefer`,optionKey:`prefer`,flag:`--prefer <prefer>`,required:!1,description:`Send respond-async to request a pollable link search job.`,schemaType:`string`,location:`header`}]},{operationId:`lookupUniqueId`,method:`GET`,path:`/v1/unique-ids/lookup`,resource:`unique-ids`,intent:`lookup`,cliPath:[`unique-ids`,`lookup`],summary:`Look Up an Identifier Owner`,description:`Resolves an external identifier to its owner(s). idType accepts a canonical token or alias; the value is normalized per type before matching. Returns every owner that carries the identifier (a value can recur across owners, e.g. a reused ticker), each row carrying its entityId or personId.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`UniqueId`,parameters:[{name:`idType`,optionKey:`idType`,flag:`--id-type <id-type>`,required:!0,description:`Identifier type token or alias, for example ein.`,schemaType:`string`,location:`query`},{name:`identifier`,optionKey:`identifier`,flag:`--identifier <identifier>`,required:!0,description:`Identifier value to resolve.`,schemaType:`string`,location:`query`}]},{operationId:`listUrlTypes`,method:`GET`,path:`/v1/url-types`,resource:`url-types`,intent:`read`,cliPath:[`url-types`,`list`],summary:`List URL Types`,description:`Read-only inventory: returns the canonical URL types and aliases accepted by entity and person URL rows. One catalog serves both owners; it writes nothing.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`UrlTypeAlias`,parameters:[]},{operationId:`searchWeb`,method:`POST`,path:`/v1/web/search`,resource:`web`,intent:`search`,cliPath:[`web`,`search`],summary:`Search the Live Web`,description:"Runs a live web search and returns its results, or a stored result when the same query was searched recently. Use it for external facts a stored record lacks, such as a publication or release date, press coverage, or an app-store listing. Each successful search uses one web search from the signed-in account's monthly allowance. Past it, a subscriber with additional usage on pays 2.5 cents per search; otherwise the call answers 429 with a usage-limit message and upgrade links. A query naming too few distinct words (a bare brand, or a brand plus a number) is refused with 422 before any charge; name what you are looking for and a disambiguator such as the domain. Set `provider` to EXA for Exa's instant search or EXA_DEEP for its slower, broader deep search; both answer synchronously. When the default search is still running after aVenture's live wait, the call answers 503 with Retry-After; send `Prefer: respond-async` to receive 202 with a Location status URL instead, and poll it after Retry-After. Neither charges an allowance search.",requestBody:[{schemaImport:`@aventurevc/api-schemas/search/search`,schemaName:`SearchSchema`,kind:`json`,contentType:`application/json`,description:`Live web search request with cache controls`,required:!0,requiredPath:[`search`],parameter:[{name:`allowSuspectedShellStrip`,optionKey:`allowSuspectedShellStrip`,flag:`--allow-suspected-shell-strip [true|false]`,required:!1,description:`Set true only when an unmarked amount in the search text is intentional.`,schemaType:`boolean`,location:`body`},{name:`bypassCache`,optionKey:`bypassCache`,flag:`--bypass-cache [true|false]`,required:!1,description:`Skip cache lookup and refresh from the search provider.`,schemaType:`boolean`,defaultValue:!1,location:`body`},{name:`cacheKey`,optionKey:`cacheKey`,flag:`--cache-key <cache-key>`,required:!1,description:`Stable lookup text for cache keying when generated search text varies between runs.`,schemaType:`string`,location:`body`},{name:`deep`,optionKey:`deep`,flag:`--deep [true|false]`,required:!1,description:"Deprecated alias for `provider: EXA_DEEP`; `true` with any other `provider` is refused with 400.",schemaType:`boolean`,defaultValue:!1,location:`body`},{name:`deferredAiOverview`,optionKey:`deferredAiOverview`,flag:`--deferred-ai-overview [true|false]`,required:!1,description:"Wait in-request for Google's AI Overview when Google defers it to a follow-up request, as it does for most company and person lookups: one extra SerpAPI search per overview not already stored. An explicit `true` also reruns a stored search older than SerpAPI's one-hour cache to get a fresh token (its one-minute overview token expired and the cache would return it unchanged). Without it, no deferred overview is fetched; one an earlier fetch stored still comes back at no extra cost. A fetch that returns no overview is not retried for six hours. An overview Google returns inline always comes back in `aiOverview` at no extra cost. Exa results never carry one.",schemaType:`boolean`,defaultValue:!1,location:`body`},{name:`language`,optionKey:`language`,flag:`--language <language>`,required:!1,description:`Search language code.`,schemaType:`string`,location:`body`},{name:`provider`,optionKey:`provider`,flag:`--provider <provider>`,required:!1,description:"Provider to search; omitted keeps the default, SerpAPI. EXA runs Exa's instant search with highlights and never falls back to SerpAPI: an Exa failure answers 503. EXA_DEEP runs Exa's slower, broader deep search (higher recall for market and provider questions, about 3-6 s) and falls back to SerpAPI on an Exa failure. Both Exa providers answer synchronously (`Prefer: respond-async` does not apply), are stored apart from SerpAPI results, and are charged like any search. Allowed values: SERPAPI, EXA, EXA_DEEP.",schemaType:`string`,choices:[`SERPAPI`,`EXA`,`EXA_DEEP`],location:`body`},{name:`region`,optionKey:`region`,flag:`--region <region>`,required:!1,description:`Search region code.`,schemaType:`string`,location:`body`},{name:`resultLimit`,optionKey:`resultLimit`,flag:`--result-limit <integer>`,required:!1,description:`Maximum number of normalized results to keep.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`retrievedFor.entityId`,optionKey:`retrievedForEntityId`,flag:`--retrieved-for-entity-id <uuid>`,required:!1,description:`Owning entity id; set only when personId is absent.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`retrievedFor.personId`,optionKey:`retrievedForPersonId`,flag:`--retrieved-for-person-id <uuid>`,required:!1,description:`Owning person id; set only when entityId is absent.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!0,description:`Search text sent to the upstream web search provider.`,schemaType:`string`,location:`body`},{name:`source`,optionKey:`source`,flag:`--source <source>`,required:!1,description:`Optional label for the calling application, up to 64 characters, stored with the search for attribution and abuse review.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`WebSearch`,detailField:[`answerBox`,`knowledgeGraph`,`relatedQuestion`,`relatedSearch`,`sportsResult`],parameters:[{name:`Idempotency-Key`,optionKey:`idempotencyKey`,flag:`--idempotency-key <idempotency-key>`,required:!1,description:`Replay key for this account's exact search request, up to 255 characters.`,schemaType:`string`,location:`header`},{name:`Prefer`,optionKey:`prefer`,flag:`--prefer <prefer>`,required:!1,description:`Send respond-async to receive a pollable job when a live web search is still running; an Exa provider answers live.`,schemaType:`string`,location:`header`}]},{operationId:`answerAgentHelpQuestion`,method:`POST`,path:`/v1/agents/help`,resource:`agents`,intent:`search`,cliPath:[`agents`,`help`,`answer`],summary:`Deprecated: Answer a Natural-Language Platform Help Question`,description:`Deprecated: use help ask (POST /v1/help) with the same body.`,deprecated:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/agent/help-question`,schemaName:`AgentHelpQuestionSchema`,kind:`json`,contentType:`application/json`,description:`A plain-English question about how to use aVenture, answered with references to the operations that do it.`,required:!0,requiredPath:[`question`],parameter:[{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional supported model for the answer. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`question`,optionKey:`question`,flag:`--question <question>`,required:!0,description:`The question to answer, in natural language.`,schemaType:`string`,location:`body`},{name:`resolve`,optionKey:`resolve`,flag:`--resolve [true|false]`,required:!1,description:`True recommends the operation or workflow that does what the question asks, or asks a clarifying question, instead of writing an answer. It ignores model and has its own per-account limit.`,schemaType:`boolean`,location:`body`},{name:`scope`,optionKey:`scope`,flag:`--scope <scope>`,required:!1,description:`Optional scope restricting which operations the answer may recommend; null means all. Allowed values: READ, WRITE, ALL.`,schemaType:`string`,choices:[`READ`,`WRITE`,`ALL`],location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],successResponse:`AgentHelp`,parameters:[]},{operationId:`getCurrentApiKey`,method:`GET`,path:`/v1/auth/api-key`,resource:`auth`,intent:`read`,cliPath:[`auth`,`api-key`,`get`],summary:`Get Current API Key`,description:`Returns provider metadata for the aVenture API key authenticating this request.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`ApiKey`,parameters:[]},{operationId:`revokeCurrentApiKey`,method:`DELETE`,path:`/v1/auth/api-key`,resource:`auth`,intent:`delete`,cliPath:[`auth`,`api-key`,`revoke`],summary:`Revoke Current API Key`,description:`Revokes the aVenture API key authenticating this request and returns its metadata so the CLI can confirm revocation before deleting its saved copy.`,scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`ApiKey`,parameters:[]},{operationId:`getAuthProviderCatalog`,method:`GET`,path:`/v1/auth/providers`,resource:`auth`,intent:`read`,cliPath:[`auth`,`providers`,`get`],summary:`Get the Sign-In Options`,description:`Sign-in options for the CLI and browser, readable before signing in. A non-null publishable key offers browser sign-in; a non-null OAuth client offers CLI sign-in.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`AuthProviderCatalog`,parameters:[]},{operationId:`updateAdditionalUsage`,method:`PATCH`,path:`/v1/billing/additional-usage`,resource:`billing`,intent:`write`,cliPath:[`billing`,`additional-usage`,`update`],summary:`Update Additional Usage Settings`,description:`Turn metered usage past the monthly allowances on or off and choose how it is paid. Free accounts can enable PREPAID_CREDIT; USAGE_INVOICE requires an active AI Plus or AI Pro subscription. Send {"enabled":false} to stop recording it. Returns the settings with this UTC month's priced usage.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/billing/additional-usage-mutation`,schemaName:`BillingAdditionalUsageMutationSchema`,kind:`json`,contentType:`application/merge-patch+json`,description:`Merge patch of the additional-usage settings. Enabling requires funding; USAGE_INVOICE also requires spendCapCents and invoiceIncrementCents.`,required:!0,requiredPath:[],parameter:[{name:`enabled`,optionKey:`enabled`,flag:`--enabled [true|false]`,required:!1,description:`Turn recording of usage past the monthly caps on or off.`,schemaType:`boolean`,location:`body`},{name:`funding`,optionKey:`funding`,flag:`--funding <funding>`,required:!1,description:`PREPAID_CREDIT spends purchased credit packs and stops when they run out. USAGE_INVOICE bills an invoice each time unbilled usage reaches invoiceIncrementCents, up to spendCapCents per month. Allowed values: PREPAID_CREDIT, USAGE_INVOICE.`,schemaType:`string`,choices:[`PREPAID_CREDIT`,`USAGE_INVOICE`],location:`body`},{name:`invoiceIncrementCents`,optionKey:`invoiceIncrementCents`,flag:`--invoice-increment-cents <integer>`,required:!1,description:`Unbilled cents that trigger a USAGE_INVOICE invoice; one of the plan catalog's invoiceIncrementCents.`,schemaType:`integer`,schemaFormat:`int64`,location:`body`},{name:`spendCapCents`,optionKey:`spendCapCents`,flag:`--spend-cap-cents <integer>`,required:!1,description:`Monthly spend cap in cents; required for USAGE_INVOICE.`,schemaType:`integer`,schemaFormat:`int64`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`BillingAdditionalUsage`,parameters:[]},{operationId:`getAiCredits`,method:`GET`,path:`/v1/billing/ai-credits`,resource:`billing`,intent:`read`,cliPath:[`billing`,`ai-credits`,`get`],summary:`Read the Current AI Credit Allowance`,description:`AI credits are Researchly messages sent in Researchly's current billing period; the cap comes from the caller's tier and resetAt is Researchly's period end.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`ResearchAllowance`,parameters:[]},{operationId:`createBillingCheckoutSession`,method:`POST`,path:`/v1/billing/checkout-sessions`,resource:`billing`,intent:`write`,cliPath:[`billing`,`checkout-sessions`,`create`],summary:`Create or Recover a Checkout Session`,description:`Start the selected AI Plus or AI Pro plan through Checkout: uiMode HOSTED_PAGE (the default) returns a hosted page url; ELEMENTS returns a clientSecret and publishableKey for the Payment Element in the caller's page. A caller with a continuing subscription changes plan with POST /v1/billing/plan-changes and cancels or resumes it with PATCH /v1/billing/subscription.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/billing/checkout-mutation`,schemaName:`BillingCheckoutMutationSchema`,kind:`json`,contentType:`application/json`,description:`Caller-selected plan and Checkout presentation for server-owned Checkout creation.`,required:!0,requiredPath:[`plan`],parameter:[{name:`plan`,optionKey:`plan`,flag:`--plan <plan>`,required:!0,description:`AI Plus or AI Pro plan to start through Checkout. Allowed values: PLUS_MONTHLY, PLUS_YEARLY, PRO_MONTHLY, PRO_YEARLY, PRO_YEARLY_PROMOTION, UNLIMITED_MONTHLY.`,schemaType:`string`,choices:[`PLUS_MONTHLY`,`PLUS_YEARLY`,`PRO_MONTHLY`,`PRO_YEARLY`,`PRO_YEARLY_PROMOTION`,`UNLIMITED_MONTHLY`],location:`body`},{name:`uiMode`,optionKey:`uiMode`,flag:`--ui-mode <ui-mode>`,required:!1,description:`How the caller presents Checkout; HOSTED_PAGE when omitted. Allowed values: HOSTED_PAGE, ELEMENTS.`,schemaType:`string`,choices:[`HOSTED_PAGE`,`ELEMENTS`],location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`BillingCheckout`,parameters:[]},{operationId:`createBillingCreditPurchase`,method:`POST`,path:`/v1/billing/credit-purchases`,resource:`billing`,intent:`write`,cliPath:[`billing`,`credit-purchases`,`create`],summary:`Buy a Prepaid Additional Usage Credit Pack`,description:`Create or replay a hosted Checkout Session for one credit pack; the paid amount becomes prepaid credit for metered usage, including free accounts. Paid plan entitlements do not change. A repeated Idempotency-Key with the same pack returns the same Session.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/billing/credit-purchase-mutation`,schemaName:`BillingCreditPurchaseMutationSchema`,kind:`json`,contentType:`application/json`,description:`Prepaid credit pack to buy through hosted Checkout.`,required:!0,requiredPath:[`pack`],parameter:[{name:`pack`,optionKey:`pack`,flag:`--pack <pack>`,required:!0,description:`Credit pack to buy; its amount becomes prepaid credit. Allowed values: USD_25, USD_50, USD_100, USD_250.`,schemaType:`string`,choices:[`USD_25`,`USD_50`,`USD_100`,`USD_250`],location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`BillingCreditPurchase`,parameters:[{name:`Idempotency-Key`,optionKey:`idempotencyKey`,flag:`--idempotency-key <idempotency-key>`,required:!0,description:`Caller-chosen key, 1 to 255 characters, that makes a retry return the same Checkout Session instead of a second purchase.`,schemaType:`string`,location:`header`}]},{operationId:`getBillingCreditPurchase`,method:`GET`,path:`/v1/billing/credit-purchases/{purchaseId}`,resource:`billing`,intent:`read`,cliPath:[`billing`,`credit-purchases`,`get`],summary:`Read a Prepaid Credit Purchase Confirmation`,description:`Read the current account's purchase amount and confirmed grant or closure time.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`BillingCreditPurchaseConfirmation`,parameters:[{name:`purchaseId`,optionKey:`purchaseId`,flag:`--purchase-id <uuid>`,required:!0,description:`Purchase identity returned by prepaid credit checkout.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`createBillingPlanChangePreview`,method:`POST`,path:`/v1/billing/plan-change-previews`,resource:`billing`,intent:`write`,cliPath:[`billing`,`plan-change-previews`,`create`],summary:`Preview a Subscription Plan Change`,description:`Show what POST /v1/billing/plan-changes would do for the same plan without changing anything: the amount charged on confirmation, when the plan takes effect, the recurring price after it, and the card on file. Refuses exactly what the plan change refuses.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/billing/plan-change-mutation`,schemaName:`BillingPlanChangeMutationSchema`,kind:`json`,contentType:`application/json`,description:`Caller-selected plan for changing a continuing AI Plus or AI Pro subscription.`,required:!0,requiredPath:[`plan`],parameter:[{name:`plan`,optionKey:`plan`,flag:`--plan <plan>`,required:!0,description:`AI Plus or AI Pro plan to move to; the current plan cancels a scheduled change. Allowed values: PLUS_MONTHLY, PLUS_YEARLY, PRO_MONTHLY, PRO_YEARLY, PRO_YEARLY_PROMOTION, UNLIMITED_MONTHLY.`,schemaType:`string`,choices:[`PLUS_MONTHLY`,`PLUS_YEARLY`,`PRO_MONTHLY`,`PRO_YEARLY`,`PRO_YEARLY_PROMOTION`,`UNLIMITED_MONTHLY`],location:`body`},{name:`prorationDate`,optionKey:`prorationDate`,flag:`--proration-date <integer>`,required:!1,description:`Unix epoch-second timestamp from an upgrade preview that pins its prorated amount on confirmation; omit it when no upgrade preview applies.`,schemaType:`integer`,schemaFormat:`int64`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`BillingPlanChangePreview`,parameters:[]},{operationId:`createBillingPlanChange`,method:`POST`,path:`/v1/billing/plan-changes`,resource:`billing`,intent:`write`,cliPath:[`billing`,`plan-changes`,`create`],summary:`Change the Subscription Plan`,description:`Move an active AI Plus or AI Pro subscription to another plan. A higher tier or a longer billing period applies now and invoices the prorated difference; paymentUrl is set when that invoice needs the customer to pay before the change applies; paymentClientSecret lets Stripe.js finish that payment in the page instead. Any other change takes effect at the current period end. Sending the current plan cancels a scheduled change. Any change resumes a subscription that was set to end at the period end.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/billing/plan-change-mutation`,schemaName:`BillingPlanChangeMutationSchema`,kind:`json`,contentType:`application/json`,description:`Caller-selected plan for changing a continuing AI Plus or AI Pro subscription.`,required:!0,requiredPath:[`plan`],parameter:[{name:`plan`,optionKey:`plan`,flag:`--plan <plan>`,required:!0,description:`AI Plus or AI Pro plan to move to; the current plan cancels a scheduled change. Allowed values: PLUS_MONTHLY, PLUS_YEARLY, PRO_MONTHLY, PRO_YEARLY, PRO_YEARLY_PROMOTION, UNLIMITED_MONTHLY.`,schemaType:`string`,choices:[`PLUS_MONTHLY`,`PLUS_YEARLY`,`PRO_MONTHLY`,`PRO_YEARLY`,`PRO_YEARLY_PROMOTION`,`UNLIMITED_MONTHLY`],location:`body`},{name:`prorationDate`,optionKey:`prorationDate`,flag:`--proration-date <integer>`,required:!1,description:`Unix epoch-second timestamp from an upgrade preview that pins its prorated amount on confirmation; omit it when no upgrade preview applies.`,schemaType:`integer`,schemaFormat:`int64`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`BillingPlanChange`,parameters:[]},{operationId:`listPlans`,method:`GET`,path:`/v1/billing/plans`,resource:`billing`,intent:`read`,cliPath:[`billing`,`plans`,`list`],summary:`List Subscription Tiers and Plans`,description:`Return every self-serve tier with its monthly allowance caps and every Checkout plan with its monthly and annual recurring prices.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`BillingCatalog`,parameters:[]},{operationId:`createBillingPortalSession`,method:`POST`,path:`/v1/billing/portal-sessions`,resource:`billing`,intent:`write`,cliPath:[`billing`,`portal-sessions`,`create`],summary:`Create a Hosted Billing Portal Session`,description:`Open the authenticated user's hosted billing portal for payment methods, invoices, and billing details. The body is optional; flow PAYMENT_METHOD_UPDATE opens straight to updating the card.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/billing/portal-mutation`,schemaName:`BillingPortalMutationSchema`,kind:`json`,contentType:`application/json`,description:`Where the hosted Billing Portal session opens.`,required:!1,requiredPath:[],parameter:[{name:`flow`,optionKey:`flow`,flag:`--flow <flow>`,required:!1,description:`PAYMENT_METHOD_UPDATE opens straight to adding or replacing the card and returns to subscription settings when done. Omit to open the portal home. Plan changes use POST /v1/billing/plan-changes and cancellation uses PATCH /v1/billing/subscription. Allowed values: PAYMENT_METHOD_UPDATE.`,schemaType:`string`,choices:[`PAYMENT_METHOD_UPDATE`],location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`BillingPortal`,parameters:[]},{operationId:`getBillingSubscription`,method:`GET`,path:`/v1/billing/subscription`,resource:`billing`,intent:`read`,cliPath:[`billing`,`subscription`,`get`],summary:`Read the Current Billing Subscription`,description:`Return sanitized Essential, AI Plus, AI Pro, or Unlimited subscription, entitlement, monthly allowance usage, and additional usage spent and available.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`BillingSubscription`,parameters:[]},{operationId:`updateBillingSubscription`,method:`PATCH`,path:`/v1/billing/subscription`,resource:`billing`,intent:`write`,cliPath:[`billing`,`subscription`,`update`],summary:`Cancel or Resume the Subscription`,description:`Set cancelAtPeriodEnd to true to end an active AI Plus or AI Pro subscription at the current period end; a scheduled plan change is dropped. Set it to false to resume the subscription and restore the plan change scheduled before the cancellation. Set paused to false to resume a PAUSED subscription, which Stripe pauses when a trial ends without a payment method: add one first with POST /v1/billing/portal-sessions, since a resume without one is refused; the resumption invoices the plan and starts a new period now. Read the result with GET /v1/billing/subscription.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/billing/subscription-mutation`,schemaName:`BillingSubscriptionMutationSchema`,kind:`json`,contentType:`application/merge-patch+json`,description:`Merge patch of a continuing AI Plus or AI Pro subscription: cancel it at the period end or resume it, including one Stripe paused.`,required:!0,requiredPath:[],parameter:[{name:`cancelAtPeriodEnd`,optionKey:`cancelAtPeriodEnd`,flag:`--cancel-at-period-end [true|false]`,required:!1,description:`true ends the subscription at the current period end and drops a scheduled plan change; false resumes it and restores the plan change scheduled before the cancellation. Omit to change nothing.`,schemaType:`boolean`,location:`body`},{name:`paused`,optionKey:`paused`,flag:`--paused [true|false]`,required:!1,description:`false resumes a subscription Stripe paused because its trial ended without a payment method; add one with POST /v1/billing/portal-sessions first. The resumption starts a new billing period now and charges the plan to that card; a declined or authentication-held charge answers 409. true, or cancelAtPeriodEnd in the same request, is refused. Omit to change nothing.`,schemaType:`boolean`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`getEntityAcquisition`,method:`GET`,path:`/v1/entities/{entityId}/acquisitions/{relationshipId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`acquisitions`,`get`],summary:`Get One Company Acquisition`,description:`Returns a row only when both sides of the acquisition are published. A 404 for an acquisition that the entity relationships resource lists means the record exists but one side is not published. A gated miss on an existing row returns 404 with title 'Acquisition Exists but a Counterpart Entity Is Not Public'. The acquired/acquirer roles in each row are always declared explicitly in the response via the acquiredEntity and acquirerEntity fields. The role query parameter selects which side of the acquisition the path entity is on: acquired (default) lists acquisitions where the path entity was bought; acquirer lists acquisitions where the path entity was the buyer; all lists or reads both sides in one response. Writes (POST/PUT/PATCH/DELETE) ignore role and always treat the path entity as acquired.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityAcquisition`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose acquisition rows are being read or written.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`relationshipId`,optionKey:`relationshipId`,flag:`--relationship-id <integer>`,required:!0,description:`Acquisition relationship row id (entity_relationship.id).`,schemaType:`integer`,schemaFormat:`int32`,location:`path`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:"Selects which side the path entity occupies in the WHERE clause: `acquired` (default) lists rows where the path entity was bought; `acquirer` lists rows where the path entity was the buyer; `all` reads either side. Allowed values: acquired, acquirer, all.",schemaType:`string`,defaultValue:`acquired`,choices:[`acquired`,`acquirer`,`all`],location:`query`}]},{operationId:`listEntityAcquisitions`,method:`GET`,path:`/v1/entities/{entityId}/acquisitions`,resource:`entities`,intent:`read`,cliPath:[`entities`,`acquisitions`,`list`],summary:`List a Company's Acquisitions`,description:`Returns a row only when both sides of the acquisition are published. A 404 for an acquisition that the entity relationships resource lists means the record exists but one side is not published. The acquired/acquirer roles in each row are always declared explicitly in the response via the acquiredEntity and acquirerEntity fields. The role query parameter selects which side of the acquisition the path entity is on: acquired (default) lists acquisitions where the path entity was bought; acquirer lists acquisitions where the path entity was the buyer; all lists or reads both sides in one response. Writes (POST/PUT/PATCH/DELETE) ignore role and always treat the path entity as acquired. List responses are ordered by most recent acquisition event first.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityAcquisition`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose acquisition rows are being read or written.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:"Selects which side the path entity occupies in the WHERE clause: `acquired` (default) lists rows where the path entity was bought; `acquirer` lists rows where the path entity was the buyer; `all` lists both sides. Allowed values: acquired, acquirer, all.",schemaType:`string`,defaultValue:`acquired`,choices:[`acquired`,`acquirer`,`all`],location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`20`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityAddress`,method:`GET`,path:`/v1/entities/{entityId}/addresses/{addressJoinId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`addresses`,`get`],summary:`Get One Company Address`,description:`Returns the physical address group containing the selected entity address association. Requires read auth.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`Address`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`addressJoinId`,optionKey:`addressJoinId`,flag:`--address-join-id <integer>`,required:!0,description:`Address join id parameter.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listEntityAddresses`,method:`GET`,path:`/v1/entities/{entityId}/addresses`,resource:`entities`,intent:`read`,cliPath:[`entities`,`addresses`,`list`],summary:`List a Company's Locations`,description:"Returns current physical addresses with their role-period associations, ordered HQ-first, primary-next, most-recent-first (`updated_at DESC`). Reads directly from the base tables so fresh writes surface immediately (bypassing the mv_entity_addresses materialized view). Set includeInactive=true as a signed-in user or with read credentials to include inactive/historical rows.",scope:`read`,auth:`none`,errorResponse:[],successResponse:`Address`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive [true|false]`,required:!1,description:`Include inactive rows.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`getEntityBlogPost`,method:`GET`,path:`/v1/entities/{entityId}/blog-posts/{blogPostId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`blog-posts`,`get`],summary:`Get One Company Blog Post`,description:`Returns one entity-owned external link by id. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`BlogPost`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the blog post row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`blogPostId`,optionKey:`blogPostId`,flag:`--blog-post-id <uuid>`,required:!0,description:`Blog post UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntityBlogPosts`,method:`GET`,path:`/v1/entities/{entityId}/blog-posts`,resource:`entities`,intent:`read`,cliPath:[`entities`,`blog-posts`,`list`],summary:`List a Company's Blog Posts`,description:`Returns active external blog post links. For news and press coverage, list news instead.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`BlogPost`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the blog post rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`10`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,defaultValue:[`publishedAt,desc`],location:`query`}]},{operationId:`getEntityBrand`,method:`GET`,path:`/v1/entities/brand`,resource:`entities`,intent:`read`,cliPath:[`entities`,`brand`,`get`],summary:`Get a Company's Names, Logos, Links, and Tags`,description:`Thin, cached read of one company by exactly one of url, slug, or entityId: brand and legal names, logos, the primary website and social profile URLs, and current classification tags. url accepts any current URL joined to the company (website, LinkedIn, X/Twitter, Crunchbase, GitHub, and other profiles) or its aVenture page; scheme, a leading www, and case are ignored, while distinct paths stay distinct. 404 when nothing owns the identifier; 409 with candidate ids when a URL is owned by more than one company. A signed-in user's read charges one brand view per distinct company per UTC month against the monthly brand view allowance, then as additional usage when the subscriber enabled it; a repeat read of the same company in the month is free, as is a read of a company whose full profile view is already charged that month, a later full profile view of the company that month reverses its brand view charge, and an exhausted cap answers 429 with Retry-After.`,scope:`read`,auth:`bearer`,errorResponse:[{status:`400`,description:`Not exactly one of url, slug, or entityId; a malformed slug or entityId; or a url that cannot be normalized.`},{status:`404`,description:`No visible company owns the identifier, including a url owned by a person.`},{status:`409`,description:`The url has more than one current owner; details.candidateEntityId and details.candidatePersonId list them. Retry with an entity candidate as entityId.`}],successResponse:`EntityBrand`,parameters:[{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Any current URL joined to the company, e.g. stripe.com.`,schemaType:`string`,location:`query`},{name:`slug`,optionKey:`recordSlug`,flag:`--record-slug <record-slug>`,required:!1,description:`Exact aVenture entity slug, e.g. stripe.`,schemaType:`string`,location:`query`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Exact entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`}]},{operationId:`listEntityClassifications`,method:`GET`,path:`/v1/entities/{entityId}/classifications`,resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`list`],summary:`List a Company's Classifications`,description:`Returns the company's classifications grouped by bucket. The default view includes current classifications; includeInactive=true adds historical ones and requires sign-in. A company that is not public returns 404.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityClassification`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive [true|false]`,required:!1,description:`Include inactive/historical entity classification join rows; default false returns only current joins.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`listEntityContent`,method:`GET`,path:`/v1/entities/{entityId}/content`,resource:`entities`,intent:`read`,cliPath:[`entities`,`content`,`list`],summary:`List a Company's Publications`,description:`Returns news articles, blog posts, repositories, websites, and pages related to an entity. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`Publication`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose publications are listed.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`topic`,optionKey:`topic`,flag:`--topic <topic>`,required:!1,description:`Topic key or source category.`,schemaType:`string`,location:`query`},{name:`contentType`,optionKey:`contentType`,flag:`--content-type <content-type>`,required:!1,description:`Public content type filter. Allowed values: newsArticle, blogPost, externalSocialPost, repositoryOwner, repository, webSite, webPage, researchPaper.`,schemaType:`string`,choices:[`newsArticle`,`blogPost`,`externalSocialPost`,`repositoryOwner`,`repository`,`webSite`,`webPage`,`researchPaper`],location:`query`},{name:`relation`,optionKey:`relation`,flag:`--relation <relation>`,required:!1,description:`Owner relation filter. Allowed values: by, about.`,schemaType:`string`,choices:[`by`,`about`],location:`query`},{name:`year`,optionKey:`year`,flag:`--year <integer>`,required:!1,description:`Best-effort content year filter.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`existenceProbe`,optionKey:`existenceProbe`,flag:`--existence-probe [true|false]`,required:!1,description:`Set true for first-page content-existence probes that do not need exact totals or stable ordering.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`searchEntityContent`,method:`POST`,path:`/v1/entities/{entityId}/content/search`,resource:`entities`,intent:`search`,cliPath:[`entities`,`content`,`search`],summary:`Search a Company's Publications`,description:`Translates plain-English constraints for one entity's content index. Any signed-in user may call this.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/natural/search`,schemaName:`NaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.`,required:!0,requiredPath:[`query`],parameter:[{name:`answerModel`,optionKey:`answerModel`,flag:`--answer-model <answer-model>`,required:!1,description:`Optional supported model for the written answer, which also supplies the page heading, title, and description. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`cacheMode`,optionKey:`cacheMode`,flag:`--cache-mode <cache-mode>`,required:!1,description:`Cache policy. use reuses earlier search work; bypass and refresh compute fresh results and are honored only for accounts with private-data access. Allowed values: use, bypass, refresh.`,schemaType:`string`,defaultValue:`use`,choices:[`use`,`bypass`,`refresh`],location:`body`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto`, `keyword`, `semantic`, and `hybrid` (`semantic` and `hybrid` only for one entity's or person's content). Allowed values: auto, exact, keyword, semantic, natural, hybrid.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`,`hybrid`],location:`body`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional supported model for planning the search. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`modelCatalogRevision`,optionKey:`modelCatalogRevision`,flag:`--model-catalog-revision <integer>`,required:!1,description:`Model catalog revision this search uses for its model defaults and inference policy; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`},{name:`reasoningEffort`,optionKey:`reasoningEffort`,flag:`--reasoning-effort <reasoning-effort>`,required:!1,description:"Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Accounts without private-data access are capped at `medium`; higher values are lowered. Allowed values: minimal, low, medium, high, xhigh, max.",schemaType:`string`,choices:[`minimal`,`low`,`medium`,`high`,`xhigh`,`max`],location:`body`},{name:`searchCatalogRevision`,optionKey:`searchCatalogRevision`,flag:`--search-catalog-revision <integer>`,required:!1,description:`Search catalog revision this search uses for its global search policy and vocabulary; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`tenantPolicyRevision`,optionKey:`tenantPolicyRevision`,flag:`--tenant-policy-revision <integer>`,required:!1,description:`Runtime policy revision this search uses for the serving deployment's execution budgets; null reads that deployment's current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],successResponse:`Publication`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose publications are searched.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityEmployeeCounts`,method:`GET`,path:`/v1/entities/{entityId}/employee-counts`,resource:`entities`,intent:`read`,cliPath:[`entities`,`employee-counts`,`list`],summary:`List a Company's Headcount Over Time`,description:`Returns employee-count time series for the entity at this address. Results are sorted newest first. This endpoint does not support custom sorting.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EmployeeCount`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned; maximum 500.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`}]},{operationId:`enrichEntity`,method:`POST`,path:`/v1/entities/{entityId}/enrichments`,resource:`entities`,intent:`write`,cliPath:[`entities`,`enrichments`,`enrich`],summary:`Enrich One Company, Product, or Service`,description:"Queues a run that researches the addressed entity and updates its aVenture profile, owned by the authenticated caller. Take entityId from match.owner when POST /v1/lookup or POST /v1/entities/lookup returns MATCHED (CLI: lookup, entities lookup). When a run for this entity is already queued or running, returns that run instead of queuing and charging another; a new run reserves one `company` research unit from the plan's research allowance, spent only once the run saves a research write and returned when it ends without one. After the run completes, read the updated profile with GET /v1/entities/{entityId} (CLI: entities get). Check the run's progress with GET /v1/research-runs/{runId} (CLI: research-runs get).",requestBody:[{schemaImport:`@aventurevc/api-schemas/enrichment/prompt`,schemaName:`EnrichmentPromptSchema`,kind:`json`,contentType:`application/json`,description:`Optional steering for one company or person enrichment run`,required:!1,requiredPath:[],parameter:[{name:`userPrompt`,optionKey:`bodyUserPrompt`,flag:`--body-user-prompt <body-user-prompt>`,required:!1,description:`Plain-language instruction for this run, such as which facts or sources to check first.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[{status:`402`,description:`Needs a plan that includes research runs; a caller without one gets 402 with code subscription_required (subscription_canceled, subscription_past_due, or subscription_paused when a plan lapsed).`}],successResponse:`HarnessRun`,detailField:[`chassis`,`chassisRouted`,`hasSourceDocument`,`lane`,`latestStatus`,`llmApi`,`maxScoutConcurrent`,`nextAttemptAt`,`subagentModel`,`taskPresetKey`,`updatedAt`],parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:`COMPREHENSIVE (the default) researches the whole profile; INDIVIDUAL runs only the tasks named in taskPresetKey. Allowed values: COMPREHENSIVE, INDIVIDUAL.`,schemaType:`string`,choices:[`COMPREHENSIVE`,`INDIVIDUAL`],location:`query`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Model id for the run's lead agent; omit to use aVenture's default model.`,schemaType:`string`,location:`query`},{name:`userPrompt`,optionKey:`userPrompt`,flag:`--user-prompt <user-prompt>`,required:!1,description:`Deprecated: send userPrompt in the EnrichmentPrompt body. Used only when the body carries no userPrompt; longer than 2000 characters is refused with 400.`,schemaType:`string`,location:`query`},{name:`taskPresetKey`,optionKey:`taskPresetKey`,flag:`--task-preset-key <task-preset-key...>`,required:!1,description:`Research presets that focus the run, listed by GET /v1/research-runs/presets; at least one is required when mode is INDIVIDUAL, and an unknown key is a 400.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityFilters`,method:`GET`,path:`/v1/entities/filters`,resource:`entities`,intent:`read`,cliPath:[`entities`,`filters`,`list`],summary:`List the Company Filter Options`,description:`Get available filter options`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityFilterOptionSet`,parameters:[{name:`typeGroup`,optionKey:`typeGroup`,flag:`--type-group <type-group>`,required:!1,description:`Type group for default filter scope. Ignored when typeRecord is provided. Allowed values: Organization, Investor.`,schemaType:`string`,choices:[`Organization`,`Investor`],location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`Filter by entity type (Company, Investor, etc.).`,schemaType:`string`,location:`query`},{name:`includeDistribution`,optionKey:`includeDistribution`,flag:`--include-distribution [true|false]`,required:!1,description:`Include range distribution charts.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`distributionKey`,optionKey:`distributionKey`,flag:`--distribution-key <distribution-key...>`,required:!1,description:`Comma-separated or repeated filter keys for chart distribution (for example amountRaised,totalRaised).`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`refineEntityFilters`,method:`POST`,path:`/v1/entities/filters/refine`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`filters`,`refine`],summary:`Refine the Company Filter Options`,description:`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.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/filter`,schemaName:`EntityFilterSchema`,kind:`json`,contentType:`application/json`,description:`Entity list and search filters. GET flattens these fields as query parameters; POST accepts the same shape as JSON.`,required:!0,requiredPath:[],parameter:[{name:`employeeCountRange[].min`,optionKey:`employeeCountRangeMin`,flag:`--employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.dateAnnouncedRange.min`,optionKey:`fundraiseDateAnnouncedRangeMin`,flag:`--fundraise-date-announced-range-min <date-time>`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.lastRoundYearRange[].min`,optionKey:`fundraiseLastRoundYearRangeMin`,flag:`--fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.totalRaisedRange[].min`,optionKey:`fundraiseTotalRaisedRangeMin`,flag:`--fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.valuationRange[].min`,optionKey:`fundraiseValuationRangeMin`,flag:`--fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`yearFoundedRange[].min`,optionKey:`yearFoundedRangeMin`,flag:`--year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`employeeCountRange[].max`,optionKey:`employeeCountRangeMax`,flag:`--employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.dateAnnouncedRange.max`,optionKey:`fundraiseDateAnnouncedRangeMax`,flag:`--fundraise-date-announced-range-max <date-time>`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.lastRoundYearRange[].max`,optionKey:`fundraiseLastRoundYearRangeMax`,flag:`--fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`fundraiseActivity.totalRaisedRange[].max`,optionKey:`fundraiseTotalRaisedRangeMax`,flag:`--fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`fundraiseActivity.valuationRange[].max`,optionKey:`fundraiseValuationRangeMax`,flag:`--fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`yearFoundedRange[].max`,optionKey:`yearFoundedRangeMax`,flag:`--year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`acceleratorBrand`,optionKey:`acceleratorBrand`,flag:`--accelerator-brand <accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorCohort`,optionKey:`acceleratorCohort`,flag:`--accelerator-cohort <accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorName`,optionKey:`acceleratorName`,flag:`--accelerator-name <accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`acceleratorStatus`,optionKey:`acceleratorStatus`,flag:`--accelerator-status <accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`affinity`,optionKey:`affinity`,flag:`--affinity <affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`closedLast`,optionKey:`closedLast`,flag:`--closed-last [true|false]`,required:!1,description:`Rank closed entities (Closed, Closed (Acquihire), Inactive) after every other textSearch or semanticQuery match, ahead of relevance and sort; omitted means true. false ranks them by relevance alone. Filter them out with operatingStatus or suppressNonOperating.`,schemaType:`boolean`,location:`body`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Exact normalized match against entity brand, legal, or alias names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`featured`,optionKey:`featured`,flag:`--featured [true|false]`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`fundraiseActivity.investedCompanyName`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.investedCountry`,optionKey:`fundraiseInvestedCountry`,flag:`--fundraise-invested-country <fundraise-invested-country...>`,required:!1,description:`Countries of the companies an investor backed, as country names or ids; a deal matches when its company's current headquarters is in one of them. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound or investedIndustry, the same deal must match each.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.investedIndustry`,optionKey:`fundraiseInvestedIndustry`,flag:`--fundraise-invested-industry <fundraise-invested-industry...>`,required:!1,description:`Industry terms for the companies an investor backed, such as Software, Artificial Intelligence, or Fintech; a term matches a portfolio company whose industry or industry classification name contains it as whole words, case-insensitively. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound, the same deal must match both.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.investedRound`,optionKey:`fundraiseInvestedRound`,flag:`--fundraise-invested-round <fundraise-invested-round...>`,required:!1,description:`Round labels of the deals an investor joined, such as Seed, Pre-Seed, or Series A; restricts returned entities to investors with such a deal inside the investment-activity horizon.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.investorName`,optionKey:`fundraiseInvestorName`,flag:`--fundraise-investor-name <fundraise-investor-name...>`,required:!1,description:`Investor names. Exact, case-sensitive match on an investor entity's brand or legal name or an individual investor's full name; restricts returned entities to companies with a fundraise that investor joined.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`fundraiseActivity.rankByInvestmentActivity`,optionKey:`fundraiseRankByInvestmentActivity`,flag:`--fundraise-rank-by-investment-activity [true|false]`,required:!1,description:`True ranks returned investors by recent deal activity ahead of any sort: each deal inside investedRound, investedIndustry, and investedCountry (every deal when all are empty) adds a weight that decays to zero over the investment-activity horizon, nudged by the investor's known USD check. Restricts returned entities to investors with such a deal.`,schemaType:`boolean`,location:`body`},{name:`fundraiseActivity.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`hasFundraising`,optionKey:`hasFundraising`,flag:`--has-fundraising [true|false]`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`headquartersCity`,optionKey:`headquartersCity`,flag:`--headquarters-city <headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`headquartersCountry`,optionKey:`headquartersCountry`,flag:`--headquarters-country <headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`headquartersState`,optionKey:`headquartersState`,flag:`--headquarters-state <headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`industry`,optionKey:`industry`,flag:`--industry <industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`location`,optionKey:`location`,flag:`--location <location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`logoOption.sortPriority`,optionKey:`logoSortPriority`,flag:`--logo-sort-priority <logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`mainProduct`,optionKey:`mainProduct`,flag:`--main-product <main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`operatingStatus`,optionKey:`operatingStatus`,flag:`--operating-status <operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`originCountry`,optionKey:`originCountry`,flag:`--origin-country <origin-country...>`,required:!1,description:`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.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`person`,optionKey:`person`,flag:`--person <person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersCity`,optionKey:`portfolioHeadquartersCity`,flag:`--portfolio-headquarters-city <portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersCountry`,optionKey:`portfolioHeadquartersCountry`,flag:`--portfolio-headquarters-country <portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`portfolioHeadquartersState`,optionKey:`portfolioHeadquartersState`,flag:`--portfolio-headquarters-state <portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`qualityGate`,optionKey:`qualityGate`,flag:`--quality-gate <quality-gate>`,required:!1,description:`Server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`rankByProminence`,optionKey:`rankByProminence`,flag:`--rank-by-prominence [true|false]`,required:!1,description:`Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean.`,schemaType:`boolean`,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`stage`,optionKey:`stage`,flag:`--stage <stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`suppressLateStage`,optionKey:`suppressLateStage`,flag:`--suppress-late-stage [true|false]`,required:!1,description:`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.`,schemaType:`boolean`,location:`body`},{name:`suppressNonOperating`,optionKey:`suppressNonOperating`,flag:`--suppress-non-operating [true|false]`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`suppressZeroTotalRaised`,optionKey:`suppressZeroTotalRaised`,flag:`--suppress-zero-total-raised [true|false]`,required:!1,description:`Suppress entities with zero or unknown USD total raised.`,schemaType:`boolean`,location:`body`},{name:`tag`,optionKey:`tag`,flag:`--tag <tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`textSearch`,optionKey:`textSearch`,flag:`--text-search <text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`typeCustomer`,optionKey:`typeCustomer`,flag:`--type-customer <type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeModel`,optionKey:`typeModel`,flag:`--type-model <type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeOwnership`,optionKey:`typeOwnership`,flag:`--type-ownership <type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`typeRevenue`,optionKey:`typeRevenue`,flag:`--type-revenue <type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`typeTechnologyUsed`,optionKey:`typeTechnologyUsed`,flag:`--type-technology-used <type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`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: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Restrict URL matching to one URL type.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],successResponse:`EntityFilterRefinedFilters`,parameters:[]},{operationId:`searchEntityFilters`,method:`POST`,path:`/v1/entities/filters/search`,resource:`entities`,intent:`search`,cliPath:[`entities`,`filters`,`search`],summary:`Look Up Filter Values Inside the Current Search`,description:`Live search within the full eligible filter universe using current entity filters. Pass the same scopeFilter used for list/refine work; the searched filter excludes its own current values so callers can expand a facet without clearing the rest of the query.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/filter-search`,schemaName:`EntityFilterSearchSchema`,kind:`json`,contentType:`application/json`,description:`Record representing a filter search request`,required:!0,requiredPath:[`filterKey`,`limit`,`query`],parameter:[{name:`scopeFilter.employeeCountRange[].min`,optionKey:`scopeFilterEmployeeCountRangeMin`,flag:`--scope-filter-employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.amountInvestedRange[].min`,optionKey:`scopeFilterFundraiseAmountInvestedRangeMin`,flag:`--scope-filter-fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.amountRaisedRange[].min`,optionKey:`scopeFilterFundraiseAmountRaisedRangeMin`,flag:`--scope-filter-fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.dateAnnouncedRange.min`,optionKey:`scopeFilterFundraiseDateAnnouncedRangeMin`,flag:`--scope-filter-fundraise-date-announced-range-min <date-time>`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`scopeFilterFundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--scope-filter-fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`scopeFilterFundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--scope-filter-fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`scopeFilterFundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--scope-filter-fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`scopeFilterFundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--scope-filter-fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`scopeFilterFundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--scope-filter-fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.lastRoundYearRange[].min`,optionKey:`scopeFilterFundraiseLastRoundYearRangeMin`,flag:`--scope-filter-fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.totalRaisedRange[].min`,optionKey:`scopeFilterFundraiseTotalRaisedRangeMin`,flag:`--scope-filter-fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.valuationRange[].min`,optionKey:`scopeFilterFundraiseValuationRangeMin`,flag:`--scope-filter-fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.yearFoundedRange[].min`,optionKey:`scopeFilterYearFoundedRangeMin`,flag:`--scope-filter-year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.employeeCountRange[].max`,optionKey:`scopeFilterEmployeeCountRangeMax`,flag:`--scope-filter-employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.amountInvestedRange[].max`,optionKey:`scopeFilterFundraiseAmountInvestedRangeMax`,flag:`--scope-filter-fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.amountRaisedRange[].max`,optionKey:`scopeFilterFundraiseAmountRaisedRangeMax`,flag:`--scope-filter-fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.dateAnnouncedRange.max`,optionKey:`scopeFilterFundraiseDateAnnouncedRangeMax`,flag:`--scope-filter-fundraise-date-announced-range-max <date-time>`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`scopeFilterFundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--scope-filter-fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`scopeFilterFundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--scope-filter-fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`scopeFilterFundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--scope-filter-fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`scopeFilterFundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--scope-filter-fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`scopeFilterFundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--scope-filter-fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.lastRoundYearRange[].max`,optionKey:`scopeFilterFundraiseLastRoundYearRangeMax`,flag:`--scope-filter-fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`scopeFilter.fundraiseActivity.totalRaisedRange[].max`,optionKey:`scopeFilterFundraiseTotalRaisedRangeMax`,flag:`--scope-filter-fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.fundraiseActivity.valuationRange[].max`,optionKey:`scopeFilterFundraiseValuationRangeMax`,flag:`--scope-filter-fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`scopeFilter.yearFoundedRange[].max`,optionKey:`scopeFilterYearFoundedRangeMax`,flag:`--scope-filter-year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filterKey`,optionKey:`filterKey`,flag:`--filter-key <filter-key>`,required:!0,description:`Filter key.`,schemaType:`string`,location:`body`},{name:`limit`,optionKey:`limit`,flag:`--limit <integer>`,required:!0,description:`Maximum number of search results.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Query.`,schemaType:`string`,location:`body`},{name:`scopeFilter.acceleratorBrand`,optionKey:`scopeFilterAcceleratorBrand`,flag:`--scope-filter-accelerator-brand <scope-filter-accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.acceleratorCohort`,optionKey:`scopeFilterAcceleratorCohort`,flag:`--scope-filter-accelerator-cohort <scope-filter-accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.acceleratorName`,optionKey:`scopeFilterAcceleratorName`,flag:`--scope-filter-accelerator-name <scope-filter-accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.acceleratorStatus`,optionKey:`scopeFilterAcceleratorStatus`,flag:`--scope-filter-accelerator-status <scope-filter-accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.affinity`,optionKey:`scopeFilterAffinity`,flag:`--scope-filter-affinity <scope-filter-affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.closedLast`,optionKey:`scopeFilterClosedLast`,flag:`--scope-filter-closed-last [true|false]`,required:!1,description:`Rank closed entities (Closed, Closed (Acquihire), Inactive) after every other textSearch or semanticQuery match, ahead of relevance and sort; omitted means true. false ranks them by relevance alone. Filter them out with operatingStatus or suppressNonOperating.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.entityId`,optionKey:`scopeFilterEntityId`,flag:`--scope-filter-entity-id <scope-filter-entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.entityName`,optionKey:`scopeFilterEntityName`,flag:`--scope-filter-entity-name <scope-filter-entity-name...>`,required:!1,description:`Exact normalized match against entity brand, legal, or alias names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.featured`,optionKey:`scopeFilterFeatured`,flag:`--scope-filter-featured [true|false]`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.fundraiseActivity.investedCompanyName`,optionKey:`scopeFilterFundraiseInvestedCompanyName`,flag:`--scope-filter-fundraise-invested-company-name <scope-filter-fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.fundraiseActivity.investedCountry`,optionKey:`scopeFilterFundraiseInvestedCountry`,flag:`--scope-filter-fundraise-invested-country <scope-filter-fundraise-invested-country...>`,required:!1,description:`Countries of the companies an investor backed, as country names or ids; a deal matches when its company's current headquarters is in one of them. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound or investedIndustry, the same deal must match each.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.fundraiseActivity.investedIndustry`,optionKey:`scopeFilterFundraiseInvestedIndustry`,flag:`--scope-filter-fundraise-invested-industry <scope-filter-fundraise-invested-industry...>`,required:!1,description:`Industry terms for the companies an investor backed, such as Software, Artificial Intelligence, or Fintech; a term matches a portfolio company whose industry or industry classification name contains it as whole words, case-insensitively. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound, the same deal must match both.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.fundraiseActivity.investedRound`,optionKey:`scopeFilterFundraiseInvestedRound`,flag:`--scope-filter-fundraise-invested-round <scope-filter-fundraise-invested-round...>`,required:!1,description:`Round labels of the deals an investor joined, such as Seed, Pre-Seed, or Series A; restricts returned entities to investors with such a deal inside the investment-activity horizon.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.fundraiseActivity.investorName`,optionKey:`scopeFilterFundraiseInvestorName`,flag:`--scope-filter-fundraise-investor-name <scope-filter-fundraise-investor-name...>`,required:!1,description:`Investor names. Exact, case-sensitive match on an investor entity's brand or legal name or an individual investor's full name; restricts returned entities to companies with a fundraise that investor joined.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.fundraiseActivity.rankByInvestmentActivity`,optionKey:`scopeFilterFundraiseRankByInvestmentActivity`,flag:`--scope-filter-fundraise-rank-by-investment-activity [true|false]`,required:!1,description:`True ranks returned investors by recent deal activity ahead of any sort: each deal inside investedRound, investedIndustry, and investedCountry (every deal when all are empty) adds a weight that decays to zero over the investment-activity horizon, nudged by the investor's known USD check. Restricts returned entities to investors with such a deal.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.fundraiseActivity.round`,optionKey:`scopeFilterFundraiseRound`,flag:`--scope-filter-fundraise-round <scope-filter-fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.hasFundraising`,optionKey:`scopeFilterHasFundraising`,flag:`--scope-filter-has-fundraising [true|false]`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.headquartersCity`,optionKey:`scopeFilterHeadquartersCity`,flag:`--scope-filter-headquarters-city <scope-filter-headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.headquartersCountry`,optionKey:`scopeFilterHeadquartersCountry`,flag:`--scope-filter-headquarters-country <scope-filter-headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.headquartersState`,optionKey:`scopeFilterHeadquartersState`,flag:`--scope-filter-headquarters-state <scope-filter-headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.industry`,optionKey:`scopeFilterIndustry`,flag:`--scope-filter-industry <scope-filter-industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.letter`,optionKey:`scopeFilterLetter`,flag:`--scope-filter-letter <scope-filter-letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`scopeFilter.location`,optionKey:`scopeFilterLocation`,flag:`--scope-filter-location <scope-filter-location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.logoOption.sortPriority`,optionKey:`scopeFilterLogoSortPriority`,flag:`--scope-filter-logo-sort-priority <scope-filter-logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`scopeFilter.mainProduct`,optionKey:`scopeFilterMainProduct`,flag:`--scope-filter-main-product <scope-filter-main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.operatingStatus`,optionKey:`scopeFilterOperatingStatus`,flag:`--scope-filter-operating-status <scope-filter-operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`scopeFilter.originCountry`,optionKey:`scopeFilterOriginCountry`,flag:`--scope-filter-origin-country <scope-filter-origin-country...>`,required:!1,description:`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.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.person`,optionKey:`scopeFilterPerson`,flag:`--scope-filter-person <scope-filter-person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.portfolioHeadquartersCity`,optionKey:`scopeFilterPortfolioHeadquartersCity`,flag:`--scope-filter-portfolio-headquarters-city <scope-filter-portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.portfolioHeadquartersCountry`,optionKey:`scopeFilterPortfolioHeadquartersCountry`,flag:`--scope-filter-portfolio-headquarters-country <scope-filter-portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.portfolioHeadquartersState`,optionKey:`scopeFilterPortfolioHeadquartersState`,flag:`--scope-filter-portfolio-headquarters-state <scope-filter-portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.qualityGate`,optionKey:`scopeFilterQualityGate`,flag:`--scope-filter-quality-gate <scope-filter-quality-gate>`,required:!1,description:`Server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`scopeFilter.rankByProminence`,optionKey:`scopeFilterRankByProminence`,flag:`--scope-filter-rank-by-prominence [true|false]`,required:!1,description:`Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.slug`,optionKey:`scopeFilterSlug`,flag:`--scope-filter-slug <scope-filter-slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.stage`,optionKey:`scopeFilterStage`,flag:`--scope-filter-stage <scope-filter-stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.suppressLateStage`,optionKey:`scopeFilterSuppressLateStage`,flag:`--scope-filter-suppress-late-stage [true|false]`,required:!1,description:`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.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.suppressNonOperating`,optionKey:`scopeFilterSuppressNonOperating`,flag:`--scope-filter-suppress-non-operating [true|false]`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.suppressZeroTotalRaised`,optionKey:`scopeFilterSuppressZeroTotalRaised`,flag:`--scope-filter-suppress-zero-total-raised [true|false]`,required:!1,description:`Suppress entities with zero or unknown USD total raised.`,schemaType:`boolean`,location:`body`},{name:`scopeFilter.tag`,optionKey:`scopeFilterTag`,flag:`--scope-filter-tag <scope-filter-tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.textSearch`,optionKey:`scopeFilterTextSearch`,flag:`--scope-filter-text-search <scope-filter-text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`scopeFilter.typeCustomer`,optionKey:`scopeFilterTypeCustomer`,flag:`--scope-filter-type-customer <scope-filter-type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.typeModel`,optionKey:`scopeFilterTypeModel`,flag:`--scope-filter-type-model <scope-filter-type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.typeOwnership`,optionKey:`scopeFilterTypeOwnership`,flag:`--scope-filter-type-ownership <scope-filter-type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.typeRecord`,optionKey:`scopeFilterTypeRecord`,flag:`--scope-filter-type-record <scope-filter-type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`scopeFilter.typeRevenue`,optionKey:`scopeFilterTypeRevenue`,flag:`--scope-filter-type-revenue <scope-filter-type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.typeTechnologyUsed`,optionKey:`scopeFilterTypeTechnologyUsed`,flag:`--scope-filter-type-technology-used <scope-filter-type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`scopeFilter.url`,optionKey:`scopeFilterUrl`,flag:`--scope-filter-url <scope-filter-url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`scopeFilter.urlDomain`,optionKey:`scopeFilterUrlDomain`,flag:`--scope-filter-url-domain <scope-filter-url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`scopeFilter.urlMatchMode`,optionKey:`scopeFilterUrlMatchMode`,flag:`--scope-filter-url-match-mode <scope-filter-url-match-mode>`,required:!1,description:`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: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`scopeFilter.urlType`,optionKey:`scopeFilterUrlType`,flag:`--scope-filter-url-type <scope-filter-url-type>`,required:!1,description:`Restrict URL matching to one URL type.`,schemaType:`string`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],successResponse:`EntityFilterSearchResult`,parameters:[]},{operationId:`getEntityFundraiseInvestorJoin`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-investor-joins/{joinId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-investor-joins`,`get`],summary:`Get One Investor on a Funding Round`,description:`Gets one entity or person investor join by join id.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityFundraiseInvestorJoin`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`joinId`,optionKey:`fundraiseInvestorJoinId`,flag:`--fundraise-investor-join-id <uuid>`,required:!0,description:`Fundraise investor join identifier.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntityFundraiseInvestorJoins`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-investor-joins`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-investor-joins`,`list`],summary:`List the Investors in a Funding Round`,description:`Lists entity or person investors joined to a fundraise round, including join-level amountInvested attribution. amountInvested is a plain decimal number in the fundraise transaction currency. Send a JSON number such as 220000 or 123456.78. Do not send currency signs, currency codes, comma grouping, quoted numeric strings, or abbreviations such as 220k or 0.22M. PATCH with amountInvested:null clears the value. Use entityId for the fundraising/portfolio company that raised the round — always a company, never the fund or investment firm that supplied the capital. For an Investment Firm's outgoing investment, pass the portfolio company that received the money here and identify the firm with investorEntityId or investorEntitySlug. Use transactionId for the round id, or round plus dateAnnounced when transactionId is unknown. To list one investor's joins, find its entityId or personId by name with GET /v1/lookup (CLI lookup --kind ENTITY or --kind PERSON) and pass it as investorEntityId or investorPersonId.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityFundraiseInvestorJoin`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`joinId`,optionKey:`fundraiseInvestorJoinId`,flag:`--fundraise-investor-join-id <uuid>`,required:!1,description:`Join identifier. When present, lookup ignores transaction and investor query parameters.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`transactionId`,optionKey:`transactionId`,flag:`--transaction-id <uuid>`,required:!1,description:`Fundraise round transaction id. The target entity id/slug is the entity that raised the round; for an Investment Firm investment, use the portfolio/fundraising company as target and identify the firm with investorEntityId or investorEntitySlug. When omitted, lookup uses the target entity plus round/dateAnnounced.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`round`,optionKey:`round`,flag:`--round <round>`,required:!1,description:`Raw fundraise round label used when transactionId is omitted.`,schemaType:`string`,location:`query`},{name:`dateAnnounced`,optionKey:`dateAnnounced`,flag:`--date-announced <date-announced>`,required:!1,description:`Exact source-stated announced date or instant used to disambiguate same-label rounds.`,schemaType:`string`,location:`query`},{name:`investorEntityId`,optionKey:`investorEntityId`,flag:`--investor-entity-id <uuid>`,required:!1,description:`Investor entity identifier. Find an investor's entityId by name with GET /v1/lookup (CLI lookup --kind ENTITY).`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`investorEntitySlug`,optionKey:`investorEntitySlug`,flag:`--investor-entity-slug <investor-entity-slug>`,required:!1,description:`Investor entity slug when investorEntityId is omitted. Find it by name with GET /v1/lookup (CLI lookup --kind ENTITY).`,schemaType:`string`,location:`query`},{name:`investorPersonId`,optionKey:`investorPersonId`,flag:`--investor-person-id <uuid>`,required:!1,description:`Investor person identifier. Find an investor's personId by name with GET /v1/lookup (CLI lookup --kind PERSON).`,schemaType:`string`,schemaFormat:`uuid`,location:`query`},{name:`investorPersonSlug`,optionKey:`investorPersonSlug`,flag:`--investor-person-slug <investor-person-slug>`,required:!1,description:`Investor person slug when investorPersonId is omitted. Find it by name with GET /v1/lookup (CLI lookup --kind PERSON).`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`}]},{operationId:`getEntityFundraiseRound`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-rounds`,`get`],summary:`Get One Funding Round`,description:`Gets one fundraise round for an entity. Use entityId for the fundraising/portfolio company that raised the round - always a company, never the fund or investment firm. For an investment made by an Investment Firm, pass the portfolio company that received the money here, not the investment firm id and not the round id. Use fundraiseRoundId for the round id.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityFundraiseTransaction`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`fundraiseRoundId`,optionKey:`fundraiseRoundId`,flag:`--fundraise-round-id <uuid>`,required:!0,description:`Fundraise round id. Use this with the entityId path segment that owns the round.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntityFundraiseRounds`,method:`GET`,path:`/v1/entities/{entityId}/fundraise-rounds`,resource:`entities`,intent:`read`,cliPath:[`entities`,`fundraise-rounds`,`list`],summary:`List a Company's Funding Rounds`,description:`Lists fundraise rounds for an entity. Use entityId for the fundraising/portfolio company that raised the round - always a company, never the fund or investment firm. For an investment made by an Investment Firm, pass the portfolio company that received the money here, not the investment firm id and not the round id.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityFundraiseTransaction`,parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index for offset paging; omit it for the first page. Ignored when cursor is sent: to continue a cursor traversal, send the X-Next-Cursor value as cursor and leave page out.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`round`,optionKey:`round`,flag:`--round <round>`,required:!1,description:`Round label contains filter.`,schemaType:`string`,location:`query`},{name:`dateFrom`,optionKey:`dateFrom`,flag:`--date-from <date>`,required:!1,description:`Inclusive minimum announced date.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`dateTo`,optionKey:`dateTo`,flag:`--date-to <date>`,required:!1,description:`Inclusive maximum announced date.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`minAmount`,optionKey:`minAmount`,flag:`--min-amount <integer>`,required:!1,description:`Inclusive minimum amount raised. Use a plain whole-number amount such as 500000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`,location:`query`},{name:`maxAmount`,optionKey:`maxAmount`,flag:`--max-amount <integer>`,required:!1,description:`Inclusive maximum amount raised. Use a plain whole-number amount such as 50000000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityInvestments`,method:`GET`,path:`/v1/entities/{entityId}/investments`,resource:`entities`,intent:`read`,cliPath:[`entities`,`investments`,`list`],summary:`List the Investments a Company Made`,description:`Lists investments made by the requesting investor entity. Use entityId to select the investor, then filter by round, dateFrom/dateTo, minAmount/maxAmount, and latestPerEntity. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amountRaised. Valid sort syntax is sort=amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values. Deep traversal uses cursor: pass the prior X-Next-Cursor value as cursor and reuse the same filters and sort.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityFundraiseTransaction`,parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index for offset paging; omit it for the first page. Ignored when cursor is sent: to continue a cursor traversal, send the X-Next-Cursor value as cursor and leave page out.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`round`,optionKey:`round`,flag:`--round <round>`,required:!1,description:`Round label contains filter.`,schemaType:`string`,location:`query`},{name:`dateFrom`,optionKey:`dateFrom`,flag:`--date-from <date>`,required:!1,description:`Inclusive minimum announced date.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`dateTo`,optionKey:`dateTo`,flag:`--date-to <date>`,required:!1,description:`Inclusive maximum announced date.`,schemaType:`string`,schemaFormat:`date`,location:`query`},{name:`minAmount`,optionKey:`minAmount`,flag:`--min-amount <integer>`,required:!1,description:`Inclusive minimum amount raised. Use a plain whole-number amount such as 500000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`,location:`query`},{name:`maxAmount`,optionKey:`maxAmount`,flag:`--max-amount <integer>`,required:!1,description:`Inclusive maximum amount raised. Use a plain whole-number amount such as 50000000; do not include currency signs, codes, comma grouping, decimals, or strings.`,schemaType:`integer`,schemaFormat:`int64`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`latestPerEntity`,optionKey:`latestPerEntity`,flag:`--latest-per-entity [true|false]`,required:!1,description:`Return latest transaction per entity.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityInvestorActivity`,method:`GET`,path:`/v1/entities/{entityId}/investor-activity`,resource:`entities`,intent:`read`,cliPath:[`entities`,`investor-activity`,`get`],summary:`Get Investor Activity`,description:`Gets the investor-perspective activity aggregate (total investments, current portfolio count, exits, and top investment stages) for an investor. Use entityId for the investor — the fund, investment firm, or company that supplied the capital — not a portfolio company that raised a round.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityFundraiseInvestorActivity`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntityInvestors`,method:`GET`,path:`/v1/entities/{entityId}/investors`,resource:`entities`,intent:`read`,cliPath:[`entities`,`investors`,`list`],summary:`List a Company's Investors`,description:`Lists entity investors with per-round investorAttribution rows. Use entityId for the fundraising/portfolio company being invested in, whose investors to list — always a company, never an investor fund or firm. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amountRaised. Valid sort syntax is sort=amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values. For more than a few investors, send compact=true: each row keeps the investor's own profile and returns its people, news, rounds, relationships, and research as empty lists.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityInvestorParticipation`,parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index for offset paging; omit it for the first page. Ignored when cursor is sent: to continue a cursor traversal, send the X-Next-Cursor value as cursor and leave page out.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit generated monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`compact`,optionKey:`compact`,flag:`--compact [true|false]`,required:!1,description:`Set true to return each investor's own profile with its people, news, funding rounds, relationships, and research as empty lists, not absent fields; the profile's sitemap flags still show which of them exist. Responses are much smaller.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityLogo`,method:`GET`,path:`/v1/entities/{entityId}/logo`,resource:`entities`,intent:`read`,cliPath:[`entities`,`logo`,`get`],summary:`Get a Company Logo`,description:"Returns the selected square or standard logo with its stored provenance; an empty slot returns 404. A Product or Service's assembled `core.image` can show its provider's logo; this slot and `entity.logo` coverage grade the entity's own asset. This is the asset fetch, not the verification proof: the accuracy check against reference marks is the logo check operation.",scope:`read`,auth:`none`,errorResponse:[],successResponse:`MediaUpload`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`logoType`,optionKey:`logoType`,flag:`--logo-type <logo-type>`,required:!1,description:"Logo slot: SQUARE (default; `core.image.logoSquare`) or STANDARD (`core.image.logo`). Allowed values: SQUARE, STANDARD.",schemaType:`string`,choices:[`SQUARE`,`STANDARD`],location:`query`}]},{operationId:`getEntityLookup`,method:`GET`,path:`/v1/entities/lookup-exact`,resource:`entities`,intent:`read`,cliPath:[`entities`,`lookup-exact`,`get`],summary:`Read Full Entity Detail by aVenture Profile URL, Slug, Website, or Domain`,description:`Start here for any aventure.vc profile URL, slug, website, or domain. Exact read: returns the full EntityDetail (names, links, funding, rounds, news, people, and research) of the one entity that identifier proves, so do not re-read it with getEntity or listEntities; it answers 404 or 409 instead of guessing. To identify a company by name and clues, use the POST lookup (CLI lookup). Detail qualifiers and visibility rules apply. UUIDs use the item route; id query parameters are rejected. Changed slugs redirect canonically. 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.`,scope:`read`,auth:`bearer`,errorResponse:[{status:`400`,description:`Conflicting or unusable identity input: name, nameBrand, and nameLegal must identify the same entity, and exactly one identifier form may be supplied.`},{status:`404`,description:`No entity resolved: fuzzy candidate signals below the review threshold without identity proof are exhausted, which does not prove the record is absent or safe to create — identify it by name and clues with GET /v1/lookup (CLI lookup --kind ENTITY). Retry this exact read only with a slug or URL copied from an aVenture page. An existing but filtered row instead reports its reason as the ProblemDetail title: Entity Exists but Is Not Public (the record exists but is not published), Product Not Public: Missing Provider Relationship, or Fund Not Public: No Public Manager Firm.`},{status:`409`,description:`Ambiguous identity: review-level candidates, unresolved identity proof, multiple exact normalized-name matches, or a Product/Service slug shared across provider pairs. ProblemDetail carries candidates; read each returned id with GET /v1/entities/{entityId}. Resolve the Product/Service ambiguity with companySlug plus slug or a provider's productService relationship.`}],successResponse:`EntityDetail`,parameters:[{name:`slug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Exact entity slug.`,schemaType:`string`,location:`query`},{name:`companySlug`,optionKey:`companySlug`,flag:`--company-slug <company-slug>`,required:!1,description:`Provider slug for Product/Service slug lookup; providerTypeRecord can narrow this to Company, Nonprofit, or Government routes.`,schemaType:`string`,location:`query`},{name:`providerTypeRecord`,optionKey:`providerTypeRecord`,flag:`--provider-type-record <provider-type-record>`,required:!1,description:"Concrete provider type qualifier for a Product/Service provider route; group-only Organization is invalid. Use with companySlug when resolving `/companies/{slug}/products-services/{product}`, `/non-profits/{slug}/products-services/{product}`, or `/government/{slug}/products-services/{product}`.",schemaType:`string`,location:`query`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`aventure.vc profile URL (such as https://aventure.vc/companies/<slug>), or the entity's own website or domain URL, matched by host and path unless urlMatchMode=domain.`,schemaType:`string`,location:`query`},{name:`urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`URL type qualifier. List the accepted tokens with GET /v1/url-types (CLI: url-types list).`,schemaType:`string`,location:`query`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL matching mode: hostPath (default for url) or domain. Omit when urlDomain is supplied; urlDomain selects domain mode automatically.`,schemaType:`string`,location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record>`,required:!1,description:`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).`,schemaType:`string`,location:`query`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!1,description:`Primary entity name candidate.`,schemaType:`string`,location:`query`},{name:`nameBrand`,optionKey:`nameBrand`,flag:`--name-brand <name-brand>`,required:!1,description:`Brand name candidate.`,schemaType:`string`,location:`query`},{name:`nameLegal`,optionKey:`nameLegal`,flag:`--name-legal <name-legal>`,required:!1,description:`Legal name candidate.`,schemaType:`string`,location:`query`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`Location candidate: city, state, or country.`,schemaType:`string`,location:`query`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Website domain candidate without protocol or path.`,schemaType:`string`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Allow generated monogram logo fallback.`,schemaType:`boolean`,location:`query`}]},{operationId:`getEntityPersonAssociation`,method:`GET`,path:`/v1/entities/{entityId}/people/{associationId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`people`,`get`],summary:`Get One Person's Role at a Company`,description:`Returns one person's role at a company.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityPersonAssociation`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`associationId`,optionKey:`associationId`,flag:`--association-id <integer>`,required:!0,description:`Association id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search term filter.`,schemaType:`string`,location:`query`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Match titleName containing this text as a whole-word phrase, ignoring case: founder matches Co-Founder, Founder & CEO, and CEO and Co-Founder, but not Founding Partner. Omit to include all titles; this does not filter titleFunction or titleLevel.`,schemaType:`string`,location:`query`},{name:`isCurrent`,optionKey:`isCurrent`,flag:`--is-current [true|false]`,required:!1,description:`Current association filter.`,schemaType:`boolean`,location:`query`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url [true|false]`,required:!1,description:`Include person URL records.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address [true|false]`,required:!1,description:`Include person address records.`,schemaType:`boolean`,location:`query`},{name:`personSlug`,optionKey:`personSlug`,flag:`--person-slug <person-slug>`,required:!1,description:`Writes only: the person's slug when the body omits personId. List reads ignore it; use search to narrow listed people.`,schemaType:`string`,location:`query`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only [true|false]`,required:!1,description:`Return count metadata without full content.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit generated monogram fallback.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntityPersonAssociations`,method:`GET`,path:`/v1/entities/{entityId}/people`,resource:`entities`,intent:`read`,cliPath:[`entities`,`people`,`list`],summary:`List the People at a Company`,description:`Returns the people associated with one company.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityPersonAssociation`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search term filter.`,schemaType:`string`,location:`query`},{name:`role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Match titleName containing this text as a whole-word phrase, ignoring case: founder matches Co-Founder, Founder & CEO, and CEO and Co-Founder, but not Founding Partner. Omit to include all titles; this does not filter titleFunction or titleLevel.`,schemaType:`string`,location:`query`},{name:`isCurrent`,optionKey:`isCurrent`,flag:`--is-current [true|false]`,required:!1,description:`Current association filter.`,schemaType:`boolean`,location:`query`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url [true|false]`,required:!1,description:`Include person URL records.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address [true|false]`,required:!1,description:`Include person address records.`,schemaType:`boolean`,location:`query`},{name:`personSlug`,optionKey:`personSlug`,flag:`--person-slug <person-slug>`,required:!1,description:`Writes only: the person's slug when the body omits personId. List reads ignore it; use search to narrow listed people.`,schemaType:`string`,location:`query`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only [true|false]`,required:!1,description:`Return count metadata without full content.`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit generated monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format property,(asc|desc), where property is one of: id, nameFirst, nameLast, nameFull, slug, createdAt, updatedAt, status, gender, amountInvested, totalInvestments. Default order is ascending; repeat sort for multiple criteria.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityPersonInvestors`,method:`GET`,path:`/v1/entities/{entityId}/person-investors`,resource:`entities`,intent:`read`,cliPath:[`entities`,`person-investors`,`list`],summary:`List Person Investors`,description:`Lists person investors with per-round investorAttribution rows. Use entityId for the fundraising/portfolio company being invested in, whose investors to list — always a company, never an investor fund or firm. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amountRaised. Valid sort syntax is sort=amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`PersonInvestorParticipation`,parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index for offset paging; omit it for the first page. Ignored when cursor is sent: to continue a cursor traversal, send the X-Next-Cursor value as cursor and leave page out.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit generated monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityRelationship`,method:`GET`,path:`/v1/entities/relationships/{relationshipId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`get`],summary:`Get One Relationship by ID`,description:`Returns one relationship by row id, including historic and non-primary rows. The response includes isCurrent and isPrimary so hidden-row cause is explicit.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityRelationship`,parameters:[{name:`relationshipId`,optionKey:`relationshipId`,flag:`--relationship-id <integer>`,required:!0,description:`Integer entity_relationship.id row id from EntityRelationship.id, not an entity UUID.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listEntityRelationships`,method:`GET`,path:`/v1/entities/{entityId}/relationships`,resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`list`],summary:`List a Company's Relationships`,description:`Returns relationship rows touching the path entity. Defaults to renderable-only rows where isCurrent=true and isPrimary=true. Set includeInactive=true to also return historic and non-primary rows; each row carries id, isCurrent, and isPrimary. Use entities relationships get to retrieve one row by id without an entity path.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityRelationship`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`type`,optionKey:`type`,flag:`--type <type>`,required:!1,description:`Optional EntityRelationshipType filter, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor. Use entities relationships types list for valid values.`,schemaType:`string`,location:`query`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive [true|false]`,required:!1,description:`Include historic or non-primary rows. Default false returns only rows where isCurrent=true and isPrimary=true.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`includeNonRenderable`,optionKey:`includeNonRenderable`,flag:`--include-non-renderable [true|false]`,required:!1,description:`Deprecated alias for includeInactive.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.`,schemaType:`string`,location:`query`},{name:`transitive`,optionKey:`transitive`,flag:`--transitive [true|false]`,required:!1,description:`When true, returns direct curated competitors with each competitor's provider comparison signals (sells-to, pricing, ownership, funding, website) nested under its productService row. Competition is not transitively closed: A-B plus B-C surfaces B from A, never C. With type=productService on a company, returns each of its Product/Service rows nesting those direct competitor rows, so one call covers every product line. Only supported for type=competingProductService or type=productService; the result is capped, so cursor and includeInactive are not accepted alongside transitive=true.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`listEntityRepositories`,method:`GET`,path:`/v1/entities/{entityId}/repositories`,resource:`entities`,intent:`read`,cliPath:[`entities`,`repositories`,`list`],summary:`List a Company's GitHub Repositories`,description:`Returns the entity's synced GitHub repositories, paged. Default sort is stargazerCount desc, then name.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`GithubRepo`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the repositories.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`50`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityResearch`,method:`GET`,path:`/v1/entities/{entityId}/research`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research`,`get`],summary:`Get the Research Gathered About a Company`,description:`Returns the consolidated research for a company.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityResearch`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getEntityResearchDetail`,method:`GET`,path:`/v1/entities/{entityId}/research-details/{detailId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-details`,`get`],summary:`Get Research Detail`,description:`Returns one research detail for an entity.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityResearchDetail`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`detailId`,optionKey:`researchDetailId`,flag:`--research-detail-id <integer>`,required:!0,description:`Research detail id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listEntityResearchDetails`,method:`GET`,path:`/v1/entities/{entityId}/research-details`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-details`,`list`],summary:`List Research Details`,description:`Returns paginated research details for an entity. Optionally filter by detail type. Rows for timeSeries=true types are history, not stale current state.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityResearchDetail`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`},{name:`type`,optionKey:`type`,flag:`--type <type>`,required:!1,description:`Research detail type token. Run GET /v1/entities/research-details/types (CLI: entities research-details types list) for the token inventory and each token's value shape.`,schemaType:`string`,location:`query`}]},{operationId:`getEntityResearchSnippet`,method:`GET`,path:`/v1/entities/{entityId}/research-snippets/{snippetId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-snippets`,`get`],summary:`Get Research Snippet`,description:`Returns one research snippet for an entity. Public reads omit private provenance fields.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityResearchSnippet`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`snippetId`,optionKey:`snippetId`,flag:`--snippet-id <integer>`,required:!0,description:`Research snippet id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listEntityResearchSnippets`,method:`GET`,path:`/v1/entities/{entityId}/research-snippets`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-snippets`,`list`],summary:`List Research Snippets`,description:`Returns paginated research snippets for one entity. Public reads omit hidden rows and private provenance fields; privileged private reads include hidden rows. Sorting is fixed by the server.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityResearchSnippet`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`}]},{operationId:`lookupSecCompany`,method:`GET`,path:`/v1/entities/sec`,resource:`entities`,intent:`lookup`,cliPath:[`entities`,`sec`,`lookup`],summary:`Get SEC EDGAR Facts for a Public Company`,description:`Resolves a publicly traded US company by ticker (preferred) or company-name query. Returns the SEC EDGAR identity facts: legal name, former names, ticker, exchange, SIC industry, state of incorporation, headquarters, and whether it is an operating company, plus the earliest EDGAR filing date and, when EDGAR holds it, the IPO prospectus (listingProspectus). SEC supplies no brand name, website, or summary text — those stay enrichment-owned and are absent here. A name query binds only the one registrant whose title equals it ignoring case and legal suffix, or the only registrant whose title contains it; several without one exact title return 409 with their tickers in resolution.acceptedValue to retry by ticker. A 404 means the query matched no SEC registrant (e.g. a private company). Read live and never persisted.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`SecCompany`,parameters:[{name:`ticker`,optionKey:`ticker`,flag:`--ticker <ticker>`,required:!1,description:`Trading ticker symbol (preferred resolver).`,schemaType:`string`,location:`query`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!1,description:`Company name query (used when no ticker is given).`,schemaType:`string`,location:`query`}]},{operationId:`listEntitySimilarEntities`,method:`GET`,path:`/v1/entities/{entityId}/similar`,resource:`entities`,intent:`read`,cliPath:[`entities`,`similar`,`list`],summary:`Get Similar Companies by ID`,description:`Returns similar entities for the UUID at this address, ordered by similarity score. Rows include the entity and similarity provenance. Use relationshipType to filter stored relationships. Custom sorting is unsupported. Any signed-in user may call this on every plan. The list is free: it never counts against the monthly record-view allowance, which charges only a separate full-detail view of one record.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntitySimilarityResult`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`relationshipType`,optionKey:`relationshipType`,flag:`--relationship-type <relationship-type>`,required:!1,description:`Filter by stored relationship type, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor.`,schemaType:`string`,location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Optional entity typeRecord filter. Repeat to allow multiple entity types.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`10`,location:`query`}]},{operationId:`getEntitySlug`,method:`GET`,path:`/v1/entities/{entityId}/slug`,resource:`entities`,intent:`read`,cliPath:[`entities`,`slug`,`get`],summary:`Get a Company's Slug`,description:`Returns the current slug, canonical path, and public URL. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`SlugLocation`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getEntityText`,method:`GET`,path:`/v1/entities/{entityId}/texts/{textId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`get`],summary:`Get One Piece of Company Text`,description:`Returns one entity-owned text row by id. Requires read auth.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityText`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the text row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`textId`,optionKey:`textId`,flag:`--text-id <integer>`,required:!0,description:`Text row id.`,schemaType:`integer`,schemaFormat:`int64`,location:`path`}]},{operationId:`listEntityTexts`,method:`GET`,path:`/v1/entities/{entityId}/texts`,resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`list`],summary:`List a Company's Text`,description:`Returns paginated text rows owned by the entity. Inactive or private rows require read auth.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityText`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the text rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityTrendingNews`,method:`GET`,path:`/v1/entities/{entityId}/trending-news`,resource:`entities`,intent:`read`,cliPath:[`entities`,`trending-news`,`list`],summary:`List Trending News About a Company`,description:`Returns trending news semantically related to the company named by the entity id path parameter.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`News`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`10`,location:`query`}]},{operationId:`listEntityTypeRecords`,method:`GET`,path:`/v1/entities/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`types`,`list`],summary:`List the Accepted typeRecord Values`,description:`Returns each accepted typeRecord value with its aliases, meaning, and public page path.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityTypeAlias`,parameters:[]},{operationId:`getEntityUniqueId`,method:`GET`,path:`/v1/entities/{entityId}/unique-ids/{uniqueIdId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`unique-ids`,`get`],summary:`Get One Company Identifier`,description:`Returns one external identifier mapping after verifying it belongs to the path owner.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`UniqueId`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`uniqueIdId`,optionKey:`uniqueIdId`,flag:`--unique-id-id <integer>`,required:!0,description:`Unique-id row id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listEntityUniqueIds`,method:`GET`,path:`/v1/entities/{entityId}/unique-ids`,resource:`entities`,intent:`read`,cliPath:[`entities`,`unique-ids`,`list`],summary:`List a Company's Identifiers`,description:`Returns paginated external identifier mappings for one owner. Sort by id, idType, identifier, createdAt, or updatedAt; default is updatedAt descending.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`UniqueId`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`50`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getEntityUrl`,method:`GET`,path:`/v1/entities/{entityId}/urls/{urlId}`,resource:`entities`,intent:`read`,cliPath:[`entities`,`urls`,`get`],summary:`Get One Company URL`,description:`Returns one entity-owned URL row by id. Requires read auth.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityUrlLink`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the URL row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`urlId`,optionKey:`urlId`,flag:`--url-id <integer>`,required:!0,description:`URL link id.`,schemaType:`integer`,schemaFormat:`int64`,location:`path`}]},{operationId:`listEntityUrls`,method:`GET`,path:`/v1/entities/{entityId}/urls`,resource:`entities`,intent:`read`,cliPath:[`entities`,`urls`,`list`],summary:`List a Company's URLs`,description:`Returns paged primary current URL rows owned by an entity. Set includeInactive=true as a signed-in user or with read credentials to include secondary active and inactive/historical rows.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityUrlLink`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID owning the URL rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive [true|false]`,required:!1,description:`Include secondary active and inactive/historical URL rows.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listEntityValuations`,method:`GET`,path:`/v1/entities/{entityId}/valuations`,resource:`entities`,intent:`read`,cliPath:[`entities`,`valuations`,`list`],summary:`List a Company's Valuation Over Time`,description:`Returns newest-first, per-UTC-month valuation points composed from stated latestValuation research details plus fundraise-round valuations. Only researchDetail points have detailId and can be changed here; fundraiseRound points are read-only here. Custom sort is not supported.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityValuationTimeSeriesPoint`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`}]},{operationId:`createNewsFeedback`,method:`POST`,path:`/v1/news/feedback`,resource:`news`,intent:`write`,cliPath:[`news`,`feedback`,`create`],summary:`Submit News Feedback`,description:`Records feedback on a news article.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/news/feedback`,schemaName:`NewsFeedbackSchema`,kind:`json`,contentType:`application/json`,description:`Feedback submission for a news article`,required:!0,requiredPath:[],parameter:[{name:`comment`,optionKey:`comment`,flag:`--comment <comment>`,required:!1,description:`Free-form feedback text.`,schemaType:`string`,location:`body`},{name:`newsId`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!1,description:`News article ID.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`reaction`,optionKey:`reaction`,flag:`--reaction <reaction>`,required:!1,description:`Short reaction (like, dislike, etc.).`,schemaType:`string`,location:`body`},{name:`slug`,optionKey:`slug`,flag:`--slug <slug>`,required:!1,description:`News article slug.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`NewsFeedbackAcknowledgement`,parameters:[]},{operationId:`listNewsRelatedEntities`,method:`GET`,path:`/v1/news/{newsId}/related-entities`,resource:`news`,intent:`read`,cliPath:[`news`,`related-entities`,`list`],summary:`List the Entities a News Article Is About`,description:`Returns entities semantically related to a news article — the article's entity mentions, not a list of articles; the article list itself is the news list.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`Entity`,parameters:[{name:`newsId`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!0,description:`News article id whose semantic neighbors should be returned.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`10`,location:`query`}]},{operationId:`listNewsSubscriptions`,method:`GET`,path:`/v1/news/subscriptions`,resource:`news`,intent:`read`,cliPath:[`news`,`subscriptions`,`list`],summary:`List Entity News Subscriptions`,description:`The caller's news webhook subscriptions with each one's delivery state. The signing secret is never returned; each item's subscription is the unsubscribe body.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`NewsSubscriptionDetail`,parameters:[]},{operationId:`subscribeNewsSubscription`,method:`PUT`,path:`/v1/news/subscriptions`,resource:`news`,intent:`write`,cliPath:[`news`,`subscriptions`,`subscribe`],summary:`Subscribe to Entity News`,description:`Creates or refreshes a webhook subscription to news newly linked to one entity. A new endpoint must echo a signed verification challenge before the subscription exists.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/news/subscription`,schemaName:`NewsSubscriptionSchema`,kind:`json`,contentType:`application/json`,description:`Subscribe or refresh one webhook subscription to news newly linked to an entity. The same caller, delivery url, event name, and arguments always address the same subscription, so repeating the call refreshes it.`,required:!0,requiredPath:[`arguments`,`arguments.entityId`,`delivery`,`delivery.mode`,`delivery.secret`,`delivery.url`,`name`],parameter:[{name:`arguments.entityId`,optionKey:`argumentsEntityId`,flag:`--arguments-entity-id <uuid>`,required:!0,description:`Entity whose newly linked public news is delivered.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque watermark from an earlier grant or event to resume after; null starts a new subscription from now and keeps an existing subscription's position.`,schemaType:`string`,location:`body`},{name:`delivery.mode`,optionKey:`deliveryMode`,flag:`--delivery-mode <delivery-mode>`,required:!0,description:`Event delivery mode. Allowed values: webhook.`,schemaType:`string`,choices:[`webhook`],location:`body`},{name:`delivery.url`,optionKey:`deliveryUrl`,flag:`--delivery-url <delivery-url>`,required:!0,description:`Public https endpoint that receives signed event POSTs.`,schemaType:`string`,location:`body`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!0,description:`Subscribable event name. Allowed values: entity.news.published.`,schemaType:`string`,choices:[`entity.news.published`],location:`body`},{name:`ttlMs`,optionKey:`ttlMs`,flag:`--ttl-ms <integer>`,required:!1,description:`Requested subscription lifetime in milliseconds; the server caps it.`,schemaType:`integer`,schemaFormat:`int64`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`NewsSubscriptionGrant`,parameters:[]},{operationId:`unsubscribeNewsSubscription`,method:`DELETE`,path:`/v1/news/subscriptions`,resource:`news`,intent:`delete`,cliPath:[`news`,`subscriptions`,`unsubscribe`],summary:`Unsubscribe From Entity News`,description:`Removes the caller's webhook subscription with this event, entity, and url.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/news/subscription-key`,schemaName:`NewsSubscriptionKeySchema`,kind:`json`,contentType:`application/json`,description:`Identifies one subscription to remove by its event name, arguments, and url.`,required:!0,requiredPath:[`arguments`,`arguments.entityId`,`delivery`,`delivery.url`,`name`],parameter:[{name:`arguments.entityId`,optionKey:`argumentsEntityId`,flag:`--arguments-entity-id <uuid>`,required:!0,description:`Entity whose newly linked public news is delivered.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`delivery.url`,optionKey:`deliveryUrl`,flag:`--delivery-url <delivery-url>`,required:!0,description:``,schemaType:`string`,location:`body`},{name:`name`,optionKey:`name`,flag:`--name <name>`,required:!0,description:`Subscribable event name. Allowed values: entity.news.published.`,schemaType:`string`,choices:[`entity.news.published`],location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],parameters:[]},{operationId:`getNewsThumbnail`,method:`GET`,path:`/v1/news/{newsId}/thumbnail`,resource:`news`,intent:`read`,cliPath:[`news`,`thumbnail`,`get`],summary:`Get News Thumbnail`,description:"Returns the article's attached thumbnail with its stored provenance; an empty slot returns 404, so read presence from `core.newsImageThumbnail` on `news get`.",scope:`read`,auth:`none`,errorResponse:[],successResponse:`MediaUpload`,parameters:[{name:`newsId`,optionKey:`newsId`,flag:`--news-id <integer>`,required:!0,description:`Exact positive news article id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`getPersonAddress`,method:`GET`,path:`/v1/people/{personId}/addresses/{addressJoinId}`,resource:`people`,intent:`read`,cliPath:[`people`,`addresses`,`get`],summary:`Get One Person's Address`,description:`Returns the physical address group containing the selected person association.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`Address`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`addressJoinId`,optionKey:`addressJoinId`,flag:`--address-join-id <integer>`,required:!0,description:`Integer person-address association id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listPersonAddresses`,method:`GET`,path:`/v1/people/{personId}/addresses`,resource:`people`,intent:`read`,cliPath:[`people`,`addresses`,`list`],summary:`List a Person's Addresses`,description:`Returns physical addresses with all role-period associations for one person.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`Address`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getPersonBlogPost`,method:`GET`,path:`/v1/people/{personId}/blog-posts/{blogPostId}`,resource:`people`,intent:`read`,cliPath:[`people`,`blog-posts`,`get`],summary:`Get One Person Blog Post`,description:`Returns one person-owned external link by id. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`BlogPost`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the blog post row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`blogPostId`,optionKey:`blogPostId`,flag:`--blog-post-id <uuid>`,required:!0,description:`Blog post UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listPersonBlogPosts`,method:`GET`,path:`/v1/people/{personId}/blog-posts`,resource:`people`,intent:`read`,cliPath:[`people`,`blog-posts`,`list`],summary:`List a Person's Blog Posts`,description:`Returns active external blog post links.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`BlogPost`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the blog post rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`10`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,defaultValue:[`publishedAt,desc`],location:`query`}]},{operationId:`listPersonContent`,method:`GET`,path:`/v1/people/{personId}/content`,resource:`people`,intent:`read`,cliPath:[`people`,`content`,`list`],summary:`List a Person's Publications`,description:`Returns news articles, blog posts, repositories, websites, and pages related to a person. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`Publication`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID whose publications are listed.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`topic`,optionKey:`topic`,flag:`--topic <topic>`,required:!1,description:`Topic key or source category.`,schemaType:`string`,location:`query`},{name:`contentType`,optionKey:`contentType`,flag:`--content-type <content-type>`,required:!1,description:`Public content type filter. Allowed values: newsArticle, blogPost, externalSocialPost, repositoryOwner, repository, webSite, webPage, researchPaper.`,schemaType:`string`,choices:[`newsArticle`,`blogPost`,`externalSocialPost`,`repositoryOwner`,`repository`,`webSite`,`webPage`,`researchPaper`],location:`query`},{name:`relation`,optionKey:`relation`,flag:`--relation <relation>`,required:!1,description:`Owner relation filter. Allowed values: by, about.`,schemaType:`string`,choices:[`by`,`about`],location:`query`},{name:`year`,optionKey:`year`,flag:`--year <integer>`,required:!1,description:`Best-effort content year filter.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`existenceProbe`,optionKey:`existenceProbe`,flag:`--existence-probe [true|false]`,required:!1,description:`Set true for first-page content-existence probes that do not need exact totals or stable ordering.`,schemaType:`boolean`,defaultValue:!1,location:`query`}]},{operationId:`searchPersonContent`,method:`POST`,path:`/v1/people/{personId}/content/search`,resource:`people`,intent:`search`,cliPath:[`people`,`content`,`search`],summary:`Search a Person's Publications`,description:`Translates plain-English constraints for one person's content index. Any signed-in user may call this.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/natural/search`,schemaName:`NaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English search request. The server plans the query into the target domain filter plus sort, then runs that domain's canonical list engine.`,required:!0,requiredPath:[`query`],parameter:[{name:`answerModel`,optionKey:`answerModel`,flag:`--answer-model <answer-model>`,required:!1,description:`Optional supported model for the written answer, which also supplies the page heading, title, and description. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`cacheMode`,optionKey:`cacheMode`,flag:`--cache-mode <cache-mode>`,required:!1,description:`Cache policy. use reuses earlier search work; bypass and refresh compute fresh results and are honored only for accounts with private-data access. Allowed values: use, bypass, refresh.`,schemaType:`string`,defaultValue:`use`,choices:[`use`,`bypass`,`refresh`],location:`body`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto`, `keyword`, `semantic`, and `hybrid` (`semantic` and `hybrid` only for one entity's or person's content). Allowed values: auto, exact, keyword, semantic, natural, hybrid.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`,`hybrid`],location:`body`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional supported model for planning the search. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`modelCatalogRevision`,optionKey:`modelCatalogRevision`,flag:`--model-catalog-revision <integer>`,required:!1,description:`Model catalog revision this search uses for its model defaults and inference policy; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`},{name:`reasoningEffort`,optionKey:`reasoningEffort`,flag:`--reasoning-effort <reasoning-effort>`,required:!1,description:"Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Accounts without private-data access are capped at `medium`; higher values are lowered. Allowed values: minimal, low, medium, high, xhigh, max.",schemaType:`string`,choices:[`minimal`,`low`,`medium`,`high`,`xhigh`,`max`],location:`body`},{name:`searchCatalogRevision`,optionKey:`searchCatalogRevision`,flag:`--search-catalog-revision <integer>`,required:!1,description:`Search catalog revision this search uses for its global search policy and vocabulary; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`tenantPolicyRevision`,optionKey:`tenantPolicyRevision`,flag:`--tenant-policy-revision <integer>`,required:!1,description:`Runtime policy revision this search uses for the serving deployment's execution budgets; null reads that deployment's current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[],successResponse:`Publication`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID whose publications are searched.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`enrichPerson`,method:`POST`,path:`/v1/people/{personId}/enrichments`,resource:`people`,intent:`write`,cliPath:[`people`,`enrichments`,`enrich`],summary:`Enrich One Person`,description:"Queues a run that researches the addressed person and updates their aVenture profile, owned by the authenticated caller. Take personId from match.owner when POST /v1/lookup or POST /v1/people/lookup returns MATCHED (CLI: lookup, people lookup). When a run for this person is already queued or running, returns that run instead of queuing and charging another; a new run reserves one `person` research unit from the plan's research allowance, spent only once the run saves a research write and returned when it ends without one. After the run completes, read the updated profile with GET /v1/people/{personId} (CLI: people get). Check the run's progress with GET /v1/research-runs/{runId} (CLI: research-runs get).",requestBody:[{schemaImport:`@aventurevc/api-schemas/enrichment/prompt`,schemaName:`EnrichmentPromptSchema`,kind:`json`,contentType:`application/json`,description:`Optional steering for one company or person enrichment run`,required:!1,requiredPath:[],parameter:[{name:`userPrompt`,optionKey:`bodyUserPrompt`,flag:`--body-user-prompt <body-user-prompt>`,required:!1,description:`Plain-language instruction for this run, such as which facts or sources to check first.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[{status:`402`,description:`Needs a plan that includes research runs; a caller without one gets 402 with code subscription_required (subscription_canceled, subscription_past_due, or subscription_paused when a plan lapsed).`}],successResponse:`HarnessRun`,detailField:[`chassis`,`chassisRouted`,`hasSourceDocument`,`lane`,`latestStatus`,`llmApi`,`maxScoutConcurrent`,`nextAttemptAt`,`subagentModel`,`taskPresetKey`,`updatedAt`],parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:`COMPREHENSIVE (the default) researches the whole profile; INDIVIDUAL runs only the tasks named in taskPresetKey. Allowed values: COMPREHENSIVE, INDIVIDUAL.`,schemaType:`string`,choices:[`COMPREHENSIVE`,`INDIVIDUAL`],location:`query`},{name:`model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Model id for the run's lead agent; omit to use aVenture's default model.`,schemaType:`string`,location:`query`},{name:`userPrompt`,optionKey:`userPrompt`,flag:`--user-prompt <user-prompt>`,required:!1,description:`Deprecated: send userPrompt in the EnrichmentPrompt body. Used only when the body carries no userPrompt; longer than 2000 characters is refused with 400.`,schemaType:`string`,location:`query`},{name:`taskPresetKey`,optionKey:`taskPresetKey`,flag:`--task-preset-key <task-preset-key...>`,required:!1,description:`Research presets that focus the run, listed by GET /v1/research-runs/presets; at least one is required when mode is INDIVIDUAL, and an unknown key is a 400.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getPersonEntityAssociation`,method:`GET`,path:`/v1/people/{personId}/entities/{associationId}`,resource:`people`,intent:`read`,cliPath:[`people`,`entities`,`get`],summary:`Get One of a Person's Roles at a Company`,description:`Returns one person-scoped association join row.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityPersonAssociation`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`associationId`,optionKey:`associationId`,flag:`--association-id <integer>`,required:!0,description:`Association id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url [true|false]`,required:!1,description:`Include entity URL records.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address [true|false]`,required:!1,description:`Include entity address records (pass false to omit).`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit generated monogram logo fallback.`,schemaType:`boolean`,location:`query`}]},{operationId:`listPersonEntityAssociations`,method:`GET`,path:`/v1/people/{personId}/entities`,resource:`people`,intent:`read`,cliPath:[`people`,`entities`,`list`],summary:`List a Person's Roles at Companies`,description:`Returns entity associations for one person.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityPersonAssociation`,parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index for offset paging; omit it for the first page. Ignored when cursor is sent: to continue a cursor traversal, send the X-Next-Cursor value as cursor and leave page out.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`countOnly`,optionKey:`countOnly`,flag:`--count-only [true|false]`,required:!1,description:`Return count metadata without full content.`,schemaType:`boolean`,location:`query`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url [true|false]`,required:!1,description:`Include entity URL records.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address [true|false]`,required:!1,description:`Include entity address records (pass false to omit).`,schemaType:`boolean`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit generated monogram logo fallback.`,schemaType:`boolean`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <cursor>`,required:!1,description:`Opaque URL-safe cursor token from X-Next-Cursor.`,schemaType:`string`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listPersonFilters`,method:`GET`,path:`/v1/people/filters`,resource:`people`,intent:`read`,cliPath:[`people`,`filters`,`list`],summary:`List Person Filter Options`,description:`Returns available people filter facets — the option inventory a filter can take (titles, statuses, and the like), not people; searching or listing people by title uses the people search and list operations with their filters.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityFilterOptionSet`,parameters:[]},{operationId:`searchPersonFilters`,method:`GET`,path:`/v1/people/filters/search`,resource:`people`,intent:`search`,cliPath:[`people`,`filters`,`search`],summary:`Search People Filter Options`,description:`Searches available people filter options.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityFilterSearchResult`,parameters:[{name:`filterKey`,optionKey:`filterKey`,flag:`--filter-key <filter-key>`,required:!0,description:`Filter key to search within.`,schemaType:`string`,location:`query`},{name:`search`,optionKey:`search`,flag:`--search <search>`,required:!0,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Page index is fixed to 0 for filter search.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned; filter-search default 20, maximum 100.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`getPersonGraph`,method:`GET`,path:`/v1/people/{personId}/graph`,resource:`people`,intent:`read`,cliPath:[`people`,`graph`,`get`],summary:`Get Person Graph`,description:`Returns the precomputed person-graph document: career context per associated entity (entity facts, recent news, colleagues, similar entities with key people) and co-investors. Lists are capped and pre-ranked; the response is the display order. Hidden people and entities are excluded at materialization. When no document has been materialized yet, returns empty lists with computedAt=null and schedules an asynchronous recompute.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`PersonGraph`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listPersonInvestments`,method:`GET`,path:`/v1/people/{personId}/investments`,resource:`people`,intent:`read`,cliPath:[`people`,`investments`,`list`],summary:`List a Person's Investments`,description:`Returns a paginated investment portfolio for a person with investorAttribution. amountInvested appears only inside investorAttribution, is a plain decimal number in the fundraise transaction currency, and is not added to amount. Valid sort syntax is sort=amountInvested,desc; do not use investorAttribution.amountInvested, amount_invested, currency signs, currency codes, comma grouping, or abbreviated values. joinId (the investor join id) is always the final tiebreak sort key, so rows tied on every requested key keep one order across pages.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`PersonInvestment`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`50`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getPersonInvestorActivity`,method:`GET`,path:`/v1/people/{personId}/investor-activity`,resource:`people`,intent:`read`,cliPath:[`people`,`investor-activity`,`get`],summary:`Get Person Investor Activity`,description:`Gets the investor-perspective activity aggregate (total investments, distinct portfolio companies, current portfolio count, exits, USD-attributed money totals, and top investment stages) for a person investor by personId. personId identifies the individual who supplied the capital — an angel or individual investor, not the company that raised the round.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityFundraiseInvestorActivity`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getPersonLookup`,method:`GET`,path:`/v1/people/lookup-exact`,resource:`people`,intent:`read`,cliPath:[`people`,`lookup-exact`,`get`],summary:`Read One Person's Full Detail by aVenture Profile URL, Slug, or URL`,description:`Start here for any aventure.vc person profile URL, slug, or personal profile URL. Exact read: returns the full PersonDetail (names, profile, company roles, and investments) of the one person a slug, URL, or candidate signals prove, so do not re-read it with getPerson or listPeople; it answers 404 or 409 instead of guessing. To identify a person by name and clues, use GET /v1/lookup (CLI lookup --kind PERSON). Use the UUID item route for an id; any id query is rejected. Canonical redirects are preserved. 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.`,scope:`read`,auth:`bearer`,errorResponse:[{status:`404`,description:`No person resolved: exact URL and bounded candidate signals are exhausted, which does not prove the record is absent — search before creating. An existing but filtered row instead reports its reason as the ProblemDetail title: Person Exists but Is Not Public (the record exists but is not published).`},{status:`409`,description:`Ambiguous identity: URL ownership or candidate signals require review. ProblemDetail identifies candidate ids and the supported recovery. Verify the candidates against source evidence and read the matching person by personId or an evidenced full profile URL with urlMatchMode=hostPath. score and threshold rank review priority; they do not prove absence. Create only when reviewed candidates are distinct and source evidence supports the target.`}],successResponse:`PersonDetail`,parameters:[{name:`slug`,optionKey:`personSlug`,flag:`--person-slug <person-slug>`,required:!1,description:`Group A — exact person slug (URL-friendly identifier). Mutually exclusive with id, url, and every candidate signal in group C.`,schemaType:`string`,location:`query`},{name:`url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Group B — aventure.vc person profile URL (such as https://aventure.vc/people/<slug>) or the person's current profile URL, resolved via strict host+path or domain-only match. Mutually exclusive with id and slug; may be combined with group-C candidate signals for URL-first fallback.`,schemaType:`string`,location:`query`},{name:`urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Optional URL type qualifier for URL lookup (e.g., 'linkedin', 'twitter'). Narrows Group B (url) and Group C (urlDomain) matching. Not an identifier on its own.`,schemaType:`string`,location:`query`},{name:`urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`URL match mode qualifier: 'hostPath' (strict host + path match, default) or 'domain' (host-only match). Not an identifier on its own.`,schemaType:`string`,location:`query`},{name:`nameFull`,optionKey:`nameFull`,flag:`--name-full <name-full>`,required:!1,description:`Group C — candidate lookup signal: person full name. Combine with other group-C signals (nameAny, location, urlDomain) for bounded candidate search. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`,location:`query`},{name:`nameAny`,optionKey:`nameAny`,flag:`--name-any <name-any>`,required:!1,description:`Group C — candidate lookup signal: loose name match (any of given/family/full). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`,location:`query`},{name:`location`,optionKey:`location`,flag:`--location <location>`,required:!1,description:`Group C — candidate lookup signal: person location (city, state, country). Combine with other group-C signals for bounded search. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`,location:`query`},{name:`urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Group C — candidate lookup signal: person URL domain (host only, no path). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback.`,schemaType:`string`,location:`query`},{name:`includeUrl`,optionKey:`includeUrl`,flag:`--include-url [true|false]`,required:!1,description:`Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array.`,schemaType:`boolean`,location:`query`},{name:`includeAssociation`,optionKey:`includeAssociation`,flag:`--include-association [true|false]`,required:!1,description:`Projection qualifier — include association values (default: true). Set false to omit association array.`,schemaType:`boolean`,location:`query`},{name:`includeAddress`,optionKey:`includeAddress`,flag:`--include-address [true|false]`,required:!1,description:`Projection qualifier — include address values (default: true). Set false to omit address array.`,schemaType:`boolean`,location:`query`},{name:`maxAssociations`,optionKey:`maxAssociations`,flag:`--max-associations <integer>`,required:!1,description:`Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response.`,schemaType:`boolean`,location:`query`},{name:`include`,optionKey:`include`,flag:`--include <include...>`,required:!1,description:`Projection qualifier — profile panels to embed in this one read (repeat or comma-separate). Each named panel answers the same rows as its own endpoint's first page; omitted panels stay absent. Allowed values: graph, investorActivity, similar, blogPost, investment.`,schemaType:`array`,itemSchemaType:`string`,choices:[`graph`,`investorActivity`,`similar`,`blogPost`,`investment`],location:`query`}]},{operationId:`getPersonPhoto`,method:`GET`,path:`/v1/people/{personId}/photo`,resource:`people`,intent:`read`,cliPath:[`people`,`photo`,`get`],summary:`Get Person Photo`,description:"Returns the person's attached photo with its stored provenance; an empty slot returns 404, so read presence from `core.image.picture` and `core.image.isMonogram` on `people get`.",scope:`read`,auth:`none`,errorResponse:[],successResponse:`MediaUpload`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listPersonRepositories`,method:`GET`,path:`/v1/people/{personId}/repositories`,resource:`people`,intent:`read`,cliPath:[`people`,`repositories`,`list`],summary:`List a Person's GitHub Repositories`,description:`Returns the person's synced GitHub repositories, paged. Default sort is stargazerCount desc, then name.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`GithubRepo`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the repositories.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`50`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listPersonSimilarPeople`,method:`GET`,path:`/v1/people/{personId}/similar`,resource:`people`,intent:`read`,cliPath:[`people`,`similar`,`list`],summary:`List People Similar to One Person`,description:`Returns people similar to the person at this address. Rows carry the person shape and per-row similarity provenance; load full detail through the person read endpoint. Results are ordered by similarity score (highest first). This endpoint does not support custom sorting. Any signed-in user may call this on every plan. The list is free: it never counts against the monthly record-view allowance, which charges only a separate full-detail view of one record.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`PersonSimilarityResult`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`X-Request-Origin`,optionKey:`xRequestOrigin`,flag:`--x-request-origin <x-request-origin>`,required:!1,description:`Attribution token identifying the requesting surface; metrics-only.`,schemaType:`string`,location:`header`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`10`,location:`query`}]},{operationId:`getPersonText`,method:`GET`,path:`/v1/people/{personId}/texts/{textId}`,resource:`people`,intent:`read`,cliPath:[`people`,`texts`,`get`],summary:`Get One Piece of Text About a Person`,description:`Returns one person-owned text row by id. Requires read auth.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityText`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the text row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`textId`,optionKey:`textId`,flag:`--text-id <integer>`,required:!0,description:`Text row id.`,schemaType:`integer`,schemaFormat:`int64`,location:`path`}]},{operationId:`listPersonTexts`,method:`GET`,path:`/v1/people/{personId}/texts`,resource:`people`,intent:`read`,cliPath:[`people`,`texts`,`list`],summary:`List Text About a Person`,description:`Returns paginated text rows owned by the person. Inactive rows require read auth.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityText`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the text rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getPersonUniqueId`,method:`GET`,path:`/v1/people/{personId}/unique-ids/{uniqueIdId}`,resource:`people`,intent:`read`,cliPath:[`people`,`unique-ids`,`get`],summary:`Get One Person Identifier`,description:`Returns one external identifier mapping after verifying it belongs to the path owner.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`UniqueId`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`uniqueIdId`,optionKey:`uniqueIdId`,flag:`--unique-id-id <integer>`,required:!0,description:`Unique-id row id.`,schemaType:`integer`,schemaFormat:`int32`,location:`path`}]},{operationId:`listPersonUniqueIds`,method:`GET`,path:`/v1/people/{personId}/unique-ids`,resource:`people`,intent:`read`,cliPath:[`people`,`unique-ids`,`list`],summary:`List a Person's Identifiers`,description:`Returns paginated external identifier mappings for one owner. Sort by id, idType, identifier, createdAt, or updatedAt; default is updatedAt descending.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`UniqueId`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Canonical person UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`50`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`getPersonUrl`,method:`GET`,path:`/v1/people/{personId}/urls/{urlId}`,resource:`people`,intent:`read`,cliPath:[`people`,`urls`,`get`],summary:`Get One Person URL`,description:`Returns one person-owned URL row by id. Requires read auth.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityUrlLink`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the URL row.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`urlId`,optionKey:`urlId`,flag:`--url-id <integer>`,required:!0,description:`URL link id.`,schemaType:`integer`,schemaFormat:`int64`,location:`path`}]},{operationId:`listPersonUrls`,method:`GET`,path:`/v1/people/{personId}/urls`,resource:`people`,intent:`read`,cliPath:[`people`,`urls`,`list`],summary:`List Person URLs`,description:`Returns paged primary current URL rows owned by a person. Set includeInactive=true as a signed-in user or with read credentials to include secondary active and inactive/historical rows.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityUrlLink`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID owning the URL rows.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`includeInactive`,optionKey:`includeInactive`,flag:`--include-inactive [true|false]`,required:!1,description:`Include secondary active and inactive/historical URL rows.`,schemaType:`boolean`,defaultValue:!1,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`25`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`listResearchRunPresets`,method:`GET`,path:`/v1/research-runs/presets`,resource:`research-runs`,intent:`read`,cliPath:[`research-runs`,`presets`,`list`],summary:`List Research Presets`,description:`Lists the presets you may send as taskPresetKey when you request research. Each preset's key is the value to send, and its name says what the run does. Every listed preset applies the facts you send in finding: the run checks each quote against its page and writes only the facts it confirms.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`AgentTaskPresetCatalog`,parameters:[]},{operationId:`searchNaturalEntities`,method:`POST`,path:`/v1/search/natural/entities`,resource:`search`,intent:`search`,cliPath:[`search`,`natural`,`entities`],summary:`Find Companies, Startups, and Investors in Natural Language`,description:`Translate a plain-English company, startup, investor, investment firm, or investment manager search into the canonical EntityFilter contract, execute the existing entity list engine, and return both the interpretation and ranked entity list page. Unsupported constraints are named in the interpretation instead of being silently ignored. A description or company discovery question belongs here; explicit filter fields are hard constraints: they override planner values, while the planner fills fields left unset. Example: search.query 'AI infrastructure companies founded since 2020' with size=3. The query accepts plain English; size limits the page, page starts at 0, and filter.yearFoundedRange [{"min":2020}] imposes a hard founding-year constraint.`,explain:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/entity/natural-search`,schemaName:`EntityNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English entity search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.`,required:!0,requiredPath:[`search`,`search.query`],parameter:[{name:`filter.employeeCountRange[].min`,optionKey:`employeeCountRangeMin`,flag:`--employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.dateAnnouncedRange.min`,optionKey:`fundraiseDateAnnouncedRangeMin`,flag:`--fundraise-date-announced-range-min <date-time>`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.lastRoundYearRange[].min`,optionKey:`fundraiseLastRoundYearRangeMin`,flag:`--fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.totalRaisedRange[].min`,optionKey:`fundraiseTotalRaisedRangeMin`,flag:`--fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.valuationRange[].min`,optionKey:`fundraiseValuationRangeMin`,flag:`--fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.yearFoundedRange[].min`,optionKey:`yearFoundedRangeMin`,flag:`--year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.employeeCountRange[].max`,optionKey:`employeeCountRangeMax`,flag:`--employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.dateAnnouncedRange.max`,optionKey:`fundraiseDateAnnouncedRangeMax`,flag:`--fundraise-date-announced-range-max <date-time>`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`fundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`fundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.lastRoundYearRange[].max`,optionKey:`fundraiseLastRoundYearRangeMax`,flag:`--fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.fundraiseActivity.totalRaisedRange[].max`,optionKey:`fundraiseTotalRaisedRangeMax`,flag:`--fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.fundraiseActivity.valuationRange[].max`,optionKey:`fundraiseValuationRangeMax`,flag:`--fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.yearFoundedRange[].max`,optionKey:`yearFoundedRangeMax`,flag:`--year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.acceleratorBrand`,optionKey:`acceleratorBrand`,flag:`--accelerator-brand <accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.acceleratorCohort`,optionKey:`acceleratorCohort`,flag:`--accelerator-cohort <accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.acceleratorName`,optionKey:`acceleratorName`,flag:`--accelerator-name <accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.acceleratorStatus`,optionKey:`acceleratorStatus`,flag:`--accelerator-status <accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.affinity`,optionKey:`affinity`,flag:`--affinity <affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.closedLast`,optionKey:`closedLast`,flag:`--closed-last [true|false]`,required:!1,description:`Rank closed entities (Closed, Closed (Acquihire), Inactive) after every other textSearch or semanticQuery match, ahead of relevance and sort; omitted means true. false ranks them by relevance alone. Filter them out with operatingStatus or suppressNonOperating.`,schemaType:`boolean`,location:`body`},{name:`filter.entityId`,optionKey:`entityId`,flag:`--entity-id <entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Exact normalized match against entity brand, legal, or alias names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.featured`,optionKey:`featured`,flag:`--featured [true|false]`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`filter.fundraiseActivity.investedCompanyName`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.fundraiseActivity.investedCountry`,optionKey:`fundraiseInvestedCountry`,flag:`--fundraise-invested-country <fundraise-invested-country...>`,required:!1,description:`Countries of the companies an investor backed, as country names or ids; a deal matches when its company's current headquarters is in one of them. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound or investedIndustry, the same deal must match each.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.fundraiseActivity.investedIndustry`,optionKey:`fundraiseInvestedIndustry`,flag:`--fundraise-invested-industry <fundraise-invested-industry...>`,required:!1,description:`Industry terms for the companies an investor backed, such as Software, Artificial Intelligence, or Fintech; a term matches a portfolio company whose industry or industry classification name contains it as whole words, case-insensitively. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound, the same deal must match both.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.fundraiseActivity.investedRound`,optionKey:`fundraiseInvestedRound`,flag:`--fundraise-invested-round <fundraise-invested-round...>`,required:!1,description:`Round labels of the deals an investor joined, such as Seed, Pre-Seed, or Series A; restricts returned entities to investors with such a deal inside the investment-activity horizon.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.fundraiseActivity.investorName`,optionKey:`fundraiseInvestorName`,flag:`--fundraise-investor-name <fundraise-investor-name...>`,required:!1,description:`Investor names. Exact, case-sensitive match on an investor entity's brand or legal name or an individual investor's full name; restricts returned entities to companies with a fundraise that investor joined.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.fundraiseActivity.rankByInvestmentActivity`,optionKey:`fundraiseRankByInvestmentActivity`,flag:`--fundraise-rank-by-investment-activity [true|false]`,required:!1,description:`True ranks returned investors by recent deal activity ahead of any sort: each deal inside investedRound, investedIndustry, and investedCountry (every deal when all are empty) adds a weight that decays to zero over the investment-activity horizon, nudged by the investor's known USD check. Restricts returned entities to investors with such a deal.`,schemaType:`boolean`,location:`body`},{name:`filter.fundraiseActivity.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.hasFundraising`,optionKey:`hasFundraising`,flag:`--has-fundraising [true|false]`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`filter.headquartersCity`,optionKey:`headquartersCity`,flag:`--headquarters-city <headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.headquartersCountry`,optionKey:`headquartersCountry`,flag:`--headquarters-country <headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.headquartersState`,optionKey:`headquartersState`,flag:`--headquarters-state <headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.industry`,optionKey:`industry`,flag:`--industry <industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`filter.location`,optionKey:`location`,flag:`--location <location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.logoOption.sortPriority`,optionKey:`logoSortPriority`,flag:`--logo-sort-priority <logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`filter.mainProduct`,optionKey:`mainProduct`,flag:`--main-product <main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.operatingStatus`,optionKey:`operatingStatus`,flag:`--operating-status <operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`filter.originCountry`,optionKey:`originCountry`,flag:`--origin-country <origin-country...>`,required:!1,description:`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.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.person`,optionKey:`person`,flag:`--person <person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.portfolioHeadquartersCity`,optionKey:`portfolioHeadquartersCity`,flag:`--portfolio-headquarters-city <portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.portfolioHeadquartersCountry`,optionKey:`portfolioHeadquartersCountry`,flag:`--portfolio-headquarters-country <portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.portfolioHeadquartersState`,optionKey:`portfolioHeadquartersState`,flag:`--portfolio-headquarters-state <portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.qualityGate`,optionKey:`qualityGate`,flag:`--quality-gate <quality-gate>`,required:!1,description:`Server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`filter.rankByProminence`,optionKey:`rankByProminence`,flag:`--rank-by-prominence [true|false]`,required:!1,description:`Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean.`,schemaType:`boolean`,location:`body`},{name:`filter.slug`,optionKey:`slug`,flag:`--slug <slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.stage`,optionKey:`stage`,flag:`--stage <stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.suppressLateStage`,optionKey:`suppressLateStage`,flag:`--suppress-late-stage [true|false]`,required:!1,description:`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.`,schemaType:`boolean`,location:`body`},{name:`filter.suppressNonOperating`,optionKey:`suppressNonOperating`,flag:`--suppress-non-operating [true|false]`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`filter.suppressZeroTotalRaised`,optionKey:`suppressZeroTotalRaised`,flag:`--suppress-zero-total-raised [true|false]`,required:!1,description:`Suppress entities with zero or unknown USD total raised.`,schemaType:`boolean`,location:`body`},{name:`filter.tag`,optionKey:`tag`,flag:`--tag <tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.textSearch`,optionKey:`textSearch`,flag:`--text-search <text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`filter.typeCustomer`,optionKey:`typeCustomer`,flag:`--type-customer <type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeModel`,optionKey:`typeModel`,flag:`--type-model <type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeOwnership`,optionKey:`typeOwnership`,flag:`--type-ownership <type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`filter.typeRevenue`,optionKey:`typeRevenue`,flag:`--type-revenue <type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.typeTechnologyUsed`,optionKey:`typeTechnologyUsed`,flag:`--type-technology-used <type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.url`,optionKey:`url`,flag:`--url <url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`filter.urlDomain`,optionKey:`urlDomain`,flag:`--url-domain <url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`filter.urlMatchMode`,optionKey:`urlMatchMode`,flag:`--url-match-mode <url-match-mode>`,required:!1,description:`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: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`filter.urlType`,optionKey:`urlType`,flag:`--url-type <url-type>`,required:!1,description:`Restrict URL matching to one URL type.`,schemaType:`string`,location:`body`},{name:`search.answerModel`,optionKey:`answerModel`,flag:`--answer-model <answer-model>`,required:!1,description:`Optional supported model for the written answer, which also supplies the page heading, title, and description. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`search.cacheMode`,optionKey:`cacheMode`,flag:`--cache-mode <cache-mode>`,required:!1,description:`Cache policy. use reuses earlier search work; bypass and refresh compute fresh results and are honored only for accounts with private-data access. Allowed values: use, bypass, refresh.`,schemaType:`string`,defaultValue:`use`,choices:[`use`,`bypass`,`refresh`],location:`body`},{name:`search.mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto`, `keyword`, `semantic`, and `hybrid` (`semantic` and `hybrid` only for one entity's or person's content). Allowed values: auto, exact, keyword, semantic, natural, hybrid.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`,`hybrid`],location:`body`},{name:`search.model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional supported model for planning the search. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`search.modelCatalogRevision`,optionKey:`modelCatalogRevision`,flag:`--model-catalog-revision <integer>`,required:!1,description:`Model catalog revision this search uses for its model defaults and inference policy; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`search.query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`},{name:`search.reasoningEffort`,optionKey:`reasoningEffort`,flag:`--reasoning-effort <reasoning-effort>`,required:!1,description:"Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Accounts without private-data access are capped at `medium`; higher values are lowered. Allowed values: minimal, low, medium, high, xhigh, max.",schemaType:`string`,choices:[`minimal`,`low`,`medium`,`high`,`xhigh`,`max`],location:`body`},{name:`search.searchCatalogRevision`,optionKey:`searchCatalogRevision`,flag:`--search-catalog-revision <integer>`,required:!1,description:`Search catalog revision this search uses for its global search policy and vocabulary; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`search.tenantPolicyRevision`,optionKey:`tenantPolicyRevision`,flag:`--tenant-policy-revision <integer>`,required:!1,description:`Runtime policy revision this search uses for the serving deployment's execution budgets; null reads that deployment's current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`This search needs a paid aVenture plan; a caller without one gets 402 with code subscription_required.`}],successResponse:`NaturalSearchResult`,parameters:[{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`When false, generated monogram logos are stripped from entity rows.`,schemaType:`boolean`,location:`query`},{name:`layer`,optionKey:`layer`,flag:`--layer <layer...>`,required:!1,description:"Optional answer layers to add beside the entity records; repeat to add more. `passage` ranks public research snippets and linked news that answer the question; `synthesis` adds a cited written answer and implies `passage`; `judgment` ranks a competitor, market, or provider question's answer by judged probability; `web` adds web evidence and the companies it names, and implies `judgment`. Allowed values: passage, synthesis, judgment, web.",schemaType:`array`,itemSchemaType:`string`,choices:[`passage`,`synthesis`,`judgment`,`web`],location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`searchNaturalPeople`,method:`POST`,path:`/v1/search/natural/people`,resource:`search`,intent:`search`,cliPath:[`search`,`natural`,`people`],summary:`Find People With Natural Language`,description:`Translate a plain-English people search into the canonical PersonFilter contract, execute the existing people list engine, and return both the interpretation and ranked people page. Broad role, employer, work-history, and profile requests use person semantic search. Explicit filter fields are hard constraints: they override planner values, while the planner fills fields left unset.`,explain:!0,requestBody:[{schemaImport:`@aventurevc/api-schemas/person/natural-search`,schemaName:`PersonNaturalSearchSchema`,kind:`json`,contentType:`application/json`,description:`Plain-English people search plus explicit hard constraints. The planner may fill only filter fields the caller leaves unset.`,required:!0,requiredPath:[`search`,`search.query`],parameter:[{name:`filter.arrayFilter.amountInvestedRange[].min`,optionKey:`fundraiseAmountInvestedRangeMin`,flag:`--fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.amountRaisedRange[].min`,optionKey:`fundraiseAmountRaisedRangeMin`,flag:`--fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.totalInvestmentCount[].min`,optionKey:`totalInvestmentCountMin`,flag:`--total-investment-count-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.entityFilter.employeeCountRange[].min`,optionKey:`entityFilterEmployeeCountRangeMin`,flag:`--entity-filter-employee-count-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.amountInvestedRange[].min`,optionKey:`entityFilterFundraiseAmountInvestedRangeMin`,flag:`--entity-filter-fundraise-amount-invested-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.amountRaisedRange[].min`,optionKey:`entityFilterFundraiseAmountRaisedRangeMin`,flag:`--entity-filter-fundraise-amount-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.dateAnnouncedRange.min`,optionKey:`entityFilterFundraiseDateAnnouncedRangeMin`,flag:`--entity-filter-fundraise-date-announced-range-min <date-time>`,required:!1,description:`Inclusive earliest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityAverageAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityLargestAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityTotalAmountInvestedUsdRangeMin`,flag:`--entity-filter-fundraise-investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].min`,optionKey:`entityFilterFundraiseInvestorActivityTotalInvestmentRangeMin`,flag:`--entity-filter-fundraise-investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.lastRoundYearRange[].min`,optionKey:`entityFilterFundraiseLastRoundYearRangeMin`,flag:`--entity-filter-fundraise-last-round-year-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.totalRaisedRange[].min`,optionKey:`entityFilterFundraiseTotalRaisedRangeMin`,flag:`--entity-filter-fundraise-total-raised-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.valuationRange[].min`,optionKey:`entityFilterFundraiseValuationRangeMin`,flag:`--entity-filter-fundraise-valuation-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.yearFoundedRange[].min`,optionKey:`entityFilterYearFoundedRangeMin`,flag:`--entity-filter-year-founded-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.investorActivity.averageAmountInvestedUsdRange[].min`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMin`,flag:`--investor-activity-average-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.largestAmountInvestedUsdRange[].min`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMin`,flag:`--investor-activity-largest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.smallestAmountInvestedUsdRange[].min`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMin`,flag:`--investor-activity-smallest-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalAmountInvestedUsdRange[].min`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMin`,flag:`--investor-activity-total-amount-invested-usd-range-min <number>`,required:!1,description:`Inclusive minimum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalInvestmentRange[].min`,optionKey:`investorActivityTotalInvestmentRangeMin`,flag:`--investor-activity-total-investment-range-min <integer>`,required:!1,description:`Inclusive minimum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.arrayFilter.amountInvestedRange[].max`,optionKey:`fundraiseAmountInvestedRangeMax`,flag:`--fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.amountRaisedRange[].max`,optionKey:`fundraiseAmountRaisedRangeMax`,flag:`--fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.arrayFilter.totalInvestmentCount[].max`,optionKey:`totalInvestmentCountMax`,flag:`--total-investment-count-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.entityFilter.employeeCountRange[].max`,optionKey:`entityFilterEmployeeCountRangeMax`,flag:`--entity-filter-employee-count-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.amountInvestedRange[].max`,optionKey:`entityFilterFundraiseAmountInvestedRangeMax`,flag:`--entity-filter-fundraise-amount-invested-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.amountRaisedRange[].max`,optionKey:`entityFilterFundraiseAmountRaisedRangeMax`,flag:`--entity-filter-fundraise-amount-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.dateAnnouncedRange.max`,optionKey:`entityFilterFundraiseDateAnnouncedRangeMax`,flag:`--entity-filter-fundraise-date-announced-range-max <date-time>`,required:!1,description:`Inclusive latest timestamp.`,schemaType:`string`,schemaFormat:`date-time`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityAverageAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityLargestAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityTotalAmountInvestedUsdRangeMax`,flag:`--entity-filter-fundraise-investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorActivity.totalInvestmentRange[].max`,optionKey:`entityFilterFundraiseInvestorActivityTotalInvestmentRangeMax`,flag:`--entity-filter-fundraise-investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.lastRoundYearRange[].max`,optionKey:`entityFilterFundraiseLastRoundYearRangeMax`,flag:`--entity-filter-fundraise-last-round-year-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.totalRaisedRange[].max`,optionKey:`entityFilterFundraiseTotalRaisedRangeMax`,flag:`--entity-filter-fundraise-total-raised-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.valuationRange[].max`,optionKey:`entityFilterFundraiseValuationRangeMax`,flag:`--entity-filter-fundraise-valuation-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.entityFilter.yearFoundedRange[].max`,optionKey:`entityFilterYearFoundedRangeMax`,flag:`--entity-filter-year-founded-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.investorActivity.averageAmountInvestedUsdRange[].max`,optionKey:`investorActivityAverageAmountInvestedUsdRangeMax`,flag:`--investor-activity-average-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.largestAmountInvestedUsdRange[].max`,optionKey:`investorActivityLargestAmountInvestedUsdRangeMax`,flag:`--investor-activity-largest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.smallestAmountInvestedUsdRange[].max`,optionKey:`investorActivitySmallestAmountInvestedUsdRangeMax`,flag:`--investor-activity-smallest-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalAmountInvestedUsdRange[].max`,optionKey:`investorActivityTotalAmountInvestedUsdRangeMax`,flag:`--investor-activity-total-amount-invested-usd-range-max <number>`,required:!1,description:`Inclusive maximum decimal number, such as 220000 or 123456.78.`,schemaType:`number`,location:`body`},{name:`filter.investorActivity.totalInvestmentRange[].max`,optionKey:`investorActivityTotalInvestmentRangeMax`,flag:`--investor-activity-total-investment-range-max <integer>`,required:!1,description:`Inclusive maximum integer.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`filter.arrayFilter.entityName`,optionKey:`entityName`,flag:`--entity-name <entity-name...>`,required:!1,description:`Associated entity names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.investedCompany`,optionKey:`fundraiseInvestedCompanyName`,flag:`--fundraise-invested-company-name <fundraise-invested-company-name...>`,required:!1,description:`Invested company names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.personTitle`,optionKey:`personTitle`,flag:`--person-title <person-title...>`,required:!1,description:`Person titles.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.round`,optionKey:`fundraiseRound`,flag:`--fundraise-round <fundraise-round...>`,required:!1,description:`Fundraise round labels.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.arrayFilter.typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Associated entity type scope. Omit or use [] for any associated type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`filter.entityFilter.acceleratorBrand`,optionKey:`entityFilterAcceleratorBrand`,flag:`--entity-filter-accelerator-brand <entity-filter-accelerator-brand...>`,required:!1,description:`Accelerator brand or operator name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.acceleratorCohort`,optionKey:`entityFilterAcceleratorCohort`,flag:`--entity-filter-accelerator-cohort <entity-filter-accelerator-cohort...>`,required:!1,description:`Accelerator batch or cohort label.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.acceleratorName`,optionKey:`entityFilterAcceleratorName`,flag:`--entity-filter-accelerator-name <entity-filter-accelerator-name...>`,required:!1,description:`Specific accelerator program name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.acceleratorStatus`,optionKey:`entityFilterAcceleratorStatus`,flag:`--entity-filter-accelerator-status <entity-filter-accelerator-status...>`,required:!1,description:`Accelerator participation status.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.affinity`,optionKey:`entityFilterAffinity`,flag:`--entity-filter-affinity <entity-filter-affinity...>`,required:!1,description:`Affinity provider organization names accepted by the companies list filter. Affinity rows are member -> provider; use provider names here, not member names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.closedLast`,optionKey:`entityFilterClosedLast`,flag:`--entity-filter-closed-last [true|false]`,required:!1,description:`Rank closed entities (Closed, Closed (Acquihire), Inactive) after every other textSearch or semanticQuery match, ahead of relevance and sort; omitted means true. false ranks them by relevance alone. Filter them out with operatingStatus or suppressNonOperating.`,schemaType:`boolean`,location:`body`},{name:`filter.entityFilter.entityId`,optionKey:`entityFilterEntityId`,flag:`--entity-filter-entity-id <entity-filter-entity-id...>`,required:!1,description:`Restrict results to specific entity IDs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.entityName`,optionKey:`entityFilterEntityName`,flag:`--entity-filter-entity-name <entity-filter-entity-name...>`,required:!1,description:`Exact normalized match against entity brand, legal, or alias names.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.featured`,optionKey:`entityFilterFeatured`,flag:`--entity-filter-featured [true|false]`,required:!1,description:`Filter by featured status.`,schemaType:`boolean`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investedCompanyName`,optionKey:`entityFilterFundraiseInvestedCompanyName`,flag:`--entity-filter-fundraise-invested-company-name <entity-filter-fundraise-invested-company-name...>`,required:!1,description:`Portfolio company names. Exact, case-sensitive match on the portfolio company's brand or legal name; restricts returned entities to investors in those companies.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investedCountry`,optionKey:`entityFilterFundraiseInvestedCountry`,flag:`--entity-filter-fundraise-invested-country <entity-filter-fundraise-invested-country...>`,required:!1,description:`Countries of the companies an investor backed, as country names or ids; a deal matches when its company's current headquarters is in one of them. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound or investedIndustry, the same deal must match each.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investedIndustry`,optionKey:`entityFilterFundraiseInvestedIndustry`,flag:`--entity-filter-fundraise-invested-industry <entity-filter-fundraise-invested-industry...>`,required:!1,description:`Industry terms for the companies an investor backed, such as Software, Artificial Intelligence, or Fintech; a term matches a portfolio company whose industry or industry classification name contains it as whole words, case-insensitively. Restricts returned entities to investors with such a deal inside the investment-activity horizon; with investedRound, the same deal must match both.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investedRound`,optionKey:`entityFilterFundraiseInvestedRound`,flag:`--entity-filter-fundraise-invested-round <entity-filter-fundraise-invested-round...>`,required:!1,description:`Round labels of the deals an investor joined, such as Seed, Pre-Seed, or Series A; restricts returned entities to investors with such a deal inside the investment-activity horizon.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.investorName`,optionKey:`entityFilterFundraiseInvestorName`,flag:`--entity-filter-fundraise-investor-name <entity-filter-fundraise-investor-name...>`,required:!1,description:`Investor names. Exact, case-sensitive match on an investor entity's brand or legal name or an individual investor's full name; restricts returned entities to companies with a fundraise that investor joined.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.rankByInvestmentActivity`,optionKey:`entityFilterFundraiseRankByInvestmentActivity`,flag:`--entity-filter-fundraise-rank-by-investment-activity [true|false]`,required:!1,description:`True ranks returned investors by recent deal activity ahead of any sort: each deal inside investedRound, investedIndustry, and investedCountry (every deal when all are empty) adds a weight that decays to zero over the investment-activity horizon, nudged by the investor's known USD check. Restricts returned entities to investors with such a deal.`,schemaType:`boolean`,location:`body`},{name:`filter.entityFilter.fundraiseActivity.round`,optionKey:`entityFilterFundraiseRound`,flag:`--entity-filter-fundraise-round <entity-filter-fundraise-round...>`,required:!1,description:`Fundraise round labels, such as Seed or Series A.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.hasFundraising`,optionKey:`entityFilterHasFundraising`,flag:`--entity-filter-has-fundraising [true|false]`,required:!1,description:`Filter to entities with fundraise activity.`,schemaType:`boolean`,location:`body`},{name:`filter.entityFilter.headquartersCity`,optionKey:`entityFilterHeadquartersCity`,flag:`--entity-filter-headquarters-city <entity-filter-headquarters-city...>`,required:!1,description:`Headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.headquartersCountry`,optionKey:`entityFilterHeadquartersCountry`,flag:`--entity-filter-headquarters-country <entity-filter-headquarters-country...>`,required:!1,description:`Headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.headquartersState`,optionKey:`entityFilterHeadquartersState`,flag:`--entity-filter-headquarters-state <entity-filter-headquarters-state...>`,required:!1,description:`Headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.industry`,optionKey:`entityFilterIndustry`,flag:`--entity-filter-industry <entity-filter-industry...>`,required:!1,description:`Industry classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.letter`,optionKey:`entityFilterLetter`,flag:`--entity-filter-letter <entity-filter-letter>`,required:!1,description:`First letter of the display name.`,schemaType:`string`,location:`body`},{name:`filter.entityFilter.location`,optionKey:`entityFilterLocation`,flag:`--entity-filter-location <entity-filter-location...>`,required:!1,description:`Geographic classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.logoOption.sortPriority`,optionKey:`entityFilterLogoSortPriority`,flag:`--entity-filter-logo-sort-priority <entity-filter-logo-sort-priority>`,required:!1,description:`Logo sort priority. Allowed values: NONE, ANY_LOGO_FIRST, REAL_LOGO_FIRST.`,schemaType:`string`,choices:[`NONE`,`ANY_LOGO_FIRST`,`REAL_LOGO_FIRST`],location:`body`},{name:`filter.entityFilter.mainProduct`,optionKey:`entityFilterMainProduct`,flag:`--entity-filter-main-product <entity-filter-main-product...>`,required:!1,description:`Main product classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.operatingStatus`,optionKey:`entityFilterOperatingStatus`,flag:`--entity-filter-operating-status <entity-filter-operating-status...>`,required:!1,description:`Operating states to include; omit to include every state. Allowed values: Operating, Acquired, Acquired Subsidiary, Closed, Closed (Acquihire), Inactive.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Operating`,`Acquired`,`Acquired Subsidiary`,`Closed`,`Closed (Acquihire)`,`Inactive`],location:`body`},{name:`filter.entityFilter.originCountry`,optionKey:`entityFilterOriginCountry`,flag:`--entity-filter-origin-country <entity-filter-origin-country...>`,required:!1,description:`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.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.person`,optionKey:`entityFilterPerson`,flag:`--entity-filter-person <entity-filter-person...>`,required:!1,description:`Associated person, matched by name.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.portfolioHeadquartersCity`,optionKey:`entityFilterPortfolioHeadquartersCity`,flag:`--entity-filter-portfolio-headquarters-city <entity-filter-portfolio-headquarters-city...>`,required:!1,description:`Portfolio-company headquarters city values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.portfolioHeadquartersCountry`,optionKey:`entityFilterPortfolioHeadquartersCountry`,flag:`--entity-filter-portfolio-headquarters-country <entity-filter-portfolio-headquarters-country...>`,required:!1,description:`Portfolio-company headquarters country values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.portfolioHeadquartersState`,optionKey:`entityFilterPortfolioHeadquartersState`,flag:`--entity-filter-portfolio-headquarters-state <entity-filter-portfolio-headquarters-state...>`,required:!1,description:`Portfolio-company headquarters state or region values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.qualityGate`,optionKey:`entityFilterQualityGate`,flag:`--entity-filter-quality-gate <entity-filter-quality-gate>`,required:!1,description:`Server-owned list quality gate. Allowed values: NONE, COMPANY_LISTING_READY.`,schemaType:`string`,choices:[`NONE`,`COMPANY_LISTING_READY`],location:`body`},{name:`filter.entityFilter.rankByProminence`,optionKey:`entityFilterRankByProminence`,flag:`--entity-filter-rank-by-prominence [true|false]`,required:!1,description:`Rank most prominent first (funding, stage, headcount, momentum, recent news, investor breadth), ahead of sort: what best, top, or most promising mean.`,schemaType:`boolean`,location:`body`},{name:`filter.entityFilter.slug`,optionKey:`entityFilterSlug`,flag:`--entity-filter-slug <entity-filter-slug...>`,required:!1,description:`Restrict results to entity slugs.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.stage`,optionKey:`entityFilterStage`,flag:`--entity-filter-stage <entity-filter-stage...>`,required:!1,description:`Investment stage classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.suppressLateStage`,optionKey:`entityFilterSuppressLateStage`,flag:`--entity-filter-suppress-late-stage [true|false]`,required:!1,description:`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.`,schemaType:`boolean`,location:`body`},{name:`filter.entityFilter.suppressNonOperating`,optionKey:`entityFilterSuppressNonOperating`,flag:`--entity-filter-suppress-non-operating [true|false]`,required:!1,description:`Suppress entities with terminal operating status.`,schemaType:`boolean`,location:`body`},{name:`filter.entityFilter.suppressZeroTotalRaised`,optionKey:`entityFilterSuppressZeroTotalRaised`,flag:`--entity-filter-suppress-zero-total-raised [true|false]`,required:!1,description:`Suppress entities with zero or unknown USD total raised.`,schemaType:`boolean`,location:`body`},{name:`filter.entityFilter.tag`,optionKey:`entityFilterTag`,flag:`--entity-filter-tag <entity-filter-tag...>`,required:!1,description:`General classification tag values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.textSearch`,optionKey:`entityFilterTextSearch`,flag:`--entity-filter-text-search <entity-filter-text-search>`,required:!1,description:`Non-blank keyword/full-text search term. Use natural-search for plain-English or multi-constraint company requests.`,schemaType:`string`,location:`body`},{name:`filter.entityFilter.typeCustomer`,optionKey:`entityFilterTypeCustomer`,flag:`--entity-filter-type-customer <entity-filter-type-customer...>`,required:!1,description:`Customer-type classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.typeModel`,optionKey:`entityFilterTypeModel`,flag:`--entity-filter-type-model <entity-filter-type-model...>`,required:!1,description:`Business-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.typeOwnership`,optionKey:`entityFilterTypeOwnership`,flag:`--entity-filter-type-ownership <entity-filter-type-ownership...>`,required:!1,description:`Ownership-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.typeRecord`,optionKey:`entityFilterTypeRecord`,flag:`--entity-filter-type-record <entity-filter-type-record...>`,required:!1,description:`Entity type filter. Organization expands to Company, Investment Firm, Nonprofit, and Government; omit to include every entity type. Allowed values: Company, Investment Firm, Fund, Nonprofit, Government, Organization, Business Line, Product, Service.`,schemaType:`array`,itemSchemaType:`string`,choices:[`Company`,`Investment Firm`,`Fund`,`Nonprofit`,`Government`,`Organization`,`Business Line`,`Product`,`Service`],location:`body`},{name:`filter.entityFilter.typeRevenue`,optionKey:`entityFilterTypeRevenue`,flag:`--entity-filter-type-revenue <entity-filter-type-revenue...>`,required:!1,description:`Revenue-model classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.typeTechnologyUsed`,optionKey:`entityFilterTypeTechnologyUsed`,flag:`--entity-filter-type-technology-used <entity-filter-type-technology-used...>`,required:!1,description:`Technology-used classification values.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.entityFilter.url`,optionKey:`entityFilterUrl`,flag:`--entity-filter-url <entity-filter-url>`,required:!1,description:`Current URL to match by normalized host and path.`,schemaType:`string`,location:`body`},{name:`filter.entityFilter.urlDomain`,optionKey:`entityFilterUrlDomain`,flag:`--entity-filter-url-domain <entity-filter-url-domain>`,required:!1,description:`Current root domain to match when urlMatchMode=domain.`,schemaType:`string`,location:`body`},{name:`filter.entityFilter.urlMatchMode`,optionKey:`entityFilterUrlMatchMode`,flag:`--entity-filter-url-match-mode <entity-filter-url-match-mode>`,required:!1,description:`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: hostPath, domain.`,schemaType:`string`,choices:[`hostPath`,`domain`],location:`body`},{name:`filter.entityFilter.urlType`,optionKey:`entityFilterUrlType`,flag:`--entity-filter-url-type <entity-filter-url-type>`,required:!1,description:`Restrict URL matching to one URL type.`,schemaType:`string`,location:`body`},{name:`filter.entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!1,description:`Associated entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`filter.entitySlug`,optionKey:`entitySlug`,flag:`--entity-slug <entity-slug>`,required:!1,description:`Associated entity slug.`,schemaType:`string`,location:`body`},{name:`filter.firstName`,optionKey:`firstName`,flag:`--first-name <first-name>`,required:!1,description:`Person first name.`,schemaType:`string`,location:`body`},{name:`filter.includeAddress`,optionKey:`includeAddress`,flag:`--include-address [true|false]`,required:!1,description:`Include addresses on each person.`,schemaType:`boolean`,location:`body`},{name:`filter.includeUrl`,optionKey:`includeUrl`,flag:`--include-url [true|false]`,required:!1,description:`Include URL links on each person.`,schemaType:`boolean`,location:`body`},{name:`filter.isCurrent`,optionKey:`isCurrent`,flag:`--is-current [true|false]`,required:!1,description:`Filter current associations.`,schemaType:`boolean`,location:`body`},{name:`filter.lastName`,optionKey:`lastName`,flag:`--last-name <last-name>`,required:!1,description:`Person last name.`,schemaType:`string`,location:`body`},{name:`filter.letter`,optionKey:`letter`,flag:`--letter <letter>`,required:!1,description:`First-name initial.`,schemaType:`string`,location:`body`},{name:`filter.personId`,optionKey:`personId`,flag:`--person-id <person-id...>`,required:!1,description:`Restrict results to specific person IDs. Omit or use [] for no ID restriction.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.personName`,optionKey:`personName`,flag:`--person-name <person-name...>`,required:!1,description:`Exact normalized match against a person's full name or slug.`,schemaType:`array`,itemSchemaType:`string`,location:`body`},{name:`filter.role`,optionKey:`role`,flag:`--role <role>`,required:!1,description:`Associated entity role or title.`,schemaType:`string`,location:`body`},{name:`filter.search`,optionKey:`search`,flag:`--search <search>`,required:!1,description:`Search keyword or phrase. Single characters valid; stop words rejected.`,schemaType:`string`,location:`body`},{name:`filter.semanticQuery`,optionKey:`semanticQuery`,flag:`--semantic-query <semantic-query>`,required:!1,description:`Semantic person search phrase. A semantic page ranks a bounded nearest-neighbor window: totalElements counts the ranked candidates reachable through continuation, not every matching person.`,schemaType:`string`,location:`body`},{name:`filter.status`,optionKey:`status`,flag:`--status <status>`,required:!1,description:`Person workflow status.`,schemaType:`string`,location:`body`},{name:`search.answerModel`,optionKey:`answerModel`,flag:`--answer-model <answer-model>`,required:!1,description:`Optional supported model for the written answer, which also supplies the page heading, title, and description. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`search.cacheMode`,optionKey:`cacheMode`,flag:`--cache-mode <cache-mode>`,required:!1,description:`Cache policy. use reuses earlier search work; bypass and refresh compute fresh results and are honored only for accounts with private-data access. Allowed values: use, bypass, refresh.`,schemaType:`string`,defaultValue:`use`,choices:[`use`,`bypass`,`refresh`],location:`body`},{name:`search.mode`,optionKey:`mode`,flag:`--mode <mode>`,required:!1,description:"Search strategy to run. Defaults to `auto`: the fast name layer runs first (a single-token query as keyword search, a multiword query as an exact normalized name) and the language-model planner runs only on a miss, so name lookups never pay for planning. Any other value forces exactly that strategy: `exact` and `keyword` skip planner model resolution and its rate limit. Entity and person natural-search take every value but `hybrid`; news and federated search accept only `auto` and `keyword`; content search accepts `auto`, `keyword`, `semantic`, and `hybrid` (`semantic` and `hybrid` only for one entity's or person's content). Allowed values: auto, exact, keyword, semantic, natural, hybrid.",schemaType:`string`,defaultValue:`auto`,choices:[`auto`,`exact`,`keyword`,`semantic`,`natural`,`hybrid`],location:`body`},{name:`search.model`,optionKey:`model`,flag:`--model <model>`,required:!1,description:`Optional supported model for planning the search. Omit it to use the default; an unsupported model answers 422.`,schemaType:`string`,location:`body`},{name:`search.modelCatalogRevision`,optionKey:`modelCatalogRevision`,flag:`--model-catalog-revision <integer>`,required:!1,description:`Model catalog revision this search uses for its model defaults and inference policy; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`search.query`,optionKey:`query`,flag:`--query <query>`,required:!0,description:`Plain-English search request.`,schemaType:`string`,location:`body`},{name:`search.reasoningEffort`,optionKey:`reasoningEffort`,flag:`--reasoning-effort <reasoning-effort>`,required:!1,description:"Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Accounts without private-data access are capped at `medium`; higher values are lowered. Allowed values: minimal, low, medium, high, xhigh, max.",schemaType:`string`,choices:[`minimal`,`low`,`medium`,`high`,`xhigh`,`max`],location:`body`},{name:`search.searchCatalogRevision`,optionKey:`searchCatalogRevision`,flag:`--search-catalog-revision <integer>`,required:!1,description:`Search catalog revision this search uses for its global search policy and vocabulary; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`},{name:`search.tenantPolicyRevision`,optionKey:`tenantPolicyRevision`,flag:`--tenant-policy-revision <integer>`,required:!1,description:`Runtime policy revision this search uses for the serving deployment's execution budgets; null reads that deployment's current revision. Callers without private-data access always read the current revision. An unknown revision returns 404.`,schemaType:`integer`,schemaFormat:`int32`,location:`body`}]}],scope:`read`,auth:`read`,errorResponse:[{status:`402`,description:`This search needs a paid aVenture plan; a caller without one gets 402 with code subscription_required.`}],successResponse:`PersonNaturalSearchResult`,parameters:[{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`When false, generated monogram pictures are stripped from person rows.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`}]},{operationId:`createSharedSearch`,method:`POST`,path:`/v1/search/shared`,resource:`search`,intent:`write`,cliPath:[`search`,`shared`,`create`],summary:`Share a Search Answer`,description:`Runs the query against public records and saves its answer under the supplied UUID. Reusing the UUID with the same query returns the original answer; a different query is rejected. The saved answer survives query-cache expiry and is readable without authentication. No result supplied by a caller is accepted.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/shared/search-mutation`,schemaName:`SharedSearchMutationSchema`,kind:`json`,contentType:`application/json`,description:`Publish a query under a stable client UUID; retries return the same saved answer.`,required:!0,requiredPath:[],parameter:[{name:`id`,optionKey:`id`,flag:`--id <uuid>`,required:!1,description:`Stable sharing UUID generated once and reused across retries.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`},{name:`query`,optionKey:`query`,flag:`--query <query>`,required:!1,description:`Plain-English query to run against public records and publish.`,schemaType:`string`,location:`body`},{name:`searchRequestId`,optionKey:`searchRequestId`,flag:`--search-request-id <uuid>`,required:!1,description:`entity.searchRequestId of the federated search response the sharing page showed. When that search was signed in, asked this query (ignoring case), and its shareable answer is still kept, the share publishes exactly that answer without searching again; otherwise it runs the default public search.`,schemaType:`string`,schemaFormat:`uuid`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`SharedSearch`,parameters:[]},{operationId:`getSharedSearch`,method:`GET`,path:`/v1/search/shared/{id}`,resource:`search`,intent:`read`,cliPath:[`search`,`shared`,`get`],summary:`Read a Shared Search Answer`,description:`Returns the persisted public answer without running the query again.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`SharedSearch`,parameters:[{name:`id`,optionKey:`recordId`,flag:`--record-id <uuid>`,required:!0,description:`Shared search UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listSharedSearch`,method:`GET`,path:`/v1/search/shared`,resource:`search`,intent:`read`,cliPath:[`search`,`shared`,`list`],summary:`List Shared Search Publications`,description:`Returns publication metadata in UUID order with a bounded keyset cursor. Answer bodies and a total count are omitted to keep sitemap traversal independent of the total number or size of saved answers. Page must be zero; follow nextCursor.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`CursorSliceSharedSearchList`,parameters:[{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Offset paging is not supported; omit page. Any value other than 0 returns 400. Send the previous response's nextCursor as cursor to read the next page.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,defaultValue:`40`,location:`query`},{name:`sort`,optionKey:`sort`,flag:`--sort <sort...>`,required:!1,description:`Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`cursor`,optionKey:`cursor`,flag:`--cursor <uuid>`,required:!1,description:`The previous page's nextCursor.`,schemaType:`string`,schemaFormat:`uuid`,location:`query`}]},{operationId:`listUniqueIdTypes`,method:`GET`,path:`/v1/unique-ids/types`,resource:`unique-ids`,intent:`read`,cliPath:[`unique-ids`,`types`,`list`],summary:`List the Accepted Unique Identifier Types`,description:`Lists the recognized external identifier types (ein, secCik, ticker, lei, duns, isin, cusip, crd, orcid) with each type's label, accepted aliases, owner scope (entity and/or person), and the format pattern a value must match on write.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`UniqueIdTypeAlias`,parameters:[]},{operationId:`authorizeOperations`,method:`POST`,path:`/v1/auth/me/permissions`,resource:`auth`,intent:`write`,cliPath:[`auth`,`me`,`permissions`,`authorize`],summary:`Authorize API Operations`,description:`Returns the supplied generated API operations that the current caller may call, alongside its existing permission grant and access class. Candidate operations are checked without being executed.`,requestBody:[{schemaImport:`@aventurevc/api-schemas/auth/operation-filter`,schemaName:`AuthOperationFilterSchema`,kind:`json`,contentType:`application/json`,description:`Bounded generated API operations to authorize for the current session.`,required:!0,requiredPath:[`operation`,`operation[].authorizationPath`,`operation[].method`,`operation[].operationId`,`operation[].path`],parameter:[{name:`operation[].authorizationPath`,optionKey:`operationAuthorizationPath`,flag:`--operation-authorization-path <operation-authorization-path>`,required:!1,description:`Concrete path for authorization. Preserve the path template's literal segments and substitute its parameters with values matching their generated schema. No request is executed against this path.`,schemaType:`string`,location:`body`},{name:`operation[].method`,optionKey:`operationMethod`,flag:`--operation-method <operation-method>`,required:!1,description:`HTTP method of the operation. Allowed values: GET, POST, PUT, PATCH, DELETE.`,schemaType:`string`,choices:[`GET`,`POST`,`PUT`,`PATCH`,`DELETE`],location:`body`},{name:`operation[].operationId`,optionKey:`operationOperationId`,flag:`--operation-operation-id <operation-operation-id>`,required:!1,description:`Generated OpenAPI operation id.`,schemaType:`string`,location:`body`},{name:`operation[].path`,optionKey:`operationPath`,flag:`--operation-path <operation-path>`,required:!1,description:`Absolute API path. A whole path segment may be an OpenAPI placeholder such as {entityId}.`,schemaType:`string`,location:`body`}]}],scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`AuthOperationAuthorization`,parameters:[]},{operationId:`getCurrentAuthPermissions`,method:`GET`,path:`/v1/auth/me/permissions`,resource:`auth`,intent:`read`,cliPath:[`auth`,`me`,`permissions`,`get`],summary:`Current User Permissions`,description:`Returns the current caller's resolved roles and permissions.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`AuthPermissionGrant`,parameters:[]},{operationId:`getBillingNextCharge`,method:`GET`,path:`/v1/billing/subscription/next-charge`,resource:`billing`,intent:`read`,cliPath:[`billing`,`subscription`,`next-charge`,`get`],summary:`Preview the Next Subscription Charge`,description:`Return what the next invoice of the caller's renewing Stripe subscription will charge and when, after coupons and credits, so a fully discounted plan reads 0. Read live from Stripe and never stored. 404 when the caller has no renewing Stripe subscription (none, cancelling, or App Store); 503 when Stripe is unavailable.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`BillingNextCharge`,parameters:[]},{operationId:`getBillingPaymentProfile`,method:`GET`,path:`/v1/billing/subscription/payment-profile`,resource:`billing`,intent:`read`,cliPath:[`billing`,`subscription`,`payment-profile`,`get`],summary:`Read Your Card on File and Introductory Offer`,description:`Return the card paying the caller's continuing Stripe subscription (brand, last four digits, expiry) and whether Checkout would charge each plan's introductoryAmount from GET /v1/billing/plans on the first payment, which only an account the App Store does not bill, with no earlier subscription, payment, or unvoided invoice, gets. Read live from Stripe and never stored; 503 when Stripe is unavailable.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`BillingPaymentProfile`,parameters:[]},{operationId:`getClassificationCatalog`,method:`GET`,path:`/v1/entities/classifications/catalog`,resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`catalog`,`get`],summary:`Get the Company Classification Taxonomy`,description:"Returns active classification buckets with optional tag lists. Each bucket carries its canonical `type`, accepted `alias[]` spellings, `tagCount`, and (when includeTags=true) the active `tag[]`. Use bucketType to scope to one bucket and includeTags=false to fetch metadata only. To find one tag, prefer the classification tag list filtered by category and name over the full catalog. Inactive tags are omitted.",scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`ClassificationCatalog`,parameters:[{name:`bucketType`,optionKey:`bucketType`,flag:`--bucket-type <bucket-type>`,required:!1,description:`Optional classification bucket. Accepts the same values as the tags endpoint type parameter.`,schemaType:`string`,location:`query`},{name:`includeTags`,optionKey:`includeTags`,flag:`--include-tags [true|false]`,required:!1,description:`When false, returns bucket metadata without tag arrays. To find one tag, prefer the classification tag list with category and q filters.`,schemaType:`boolean`,location:`query`}]},{operationId:`listEntityClassificationSuggestions`,method:`GET`,path:`/v1/entities/{entityId}/classifications/suggestions`,resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`suggestions`,`list`],summary:`Suggest Classifications for a Company`,description:`Returns ranked tag and standard industry code suggestions for the company, based on similar companies. mainProduct is never suggested, and an empty array means no similar company suggests anything. Requires sign-in; a company that is not public returns 404.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntityClassificationSuggestion`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Canonical entity UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`limit`,optionKey:`limit`,flag:`--limit <integer>`,required:!1,description:`Maximum suggestions to return; default 12, maximum 50.`,schemaType:`integer`,schemaFormat:`int32`,location:`query`}]},{operationId:`listClassifications`,method:`GET`,path:`/v1/entities/classifications/tags`,resource:`entities`,intent:`read`,cliPath:[`entities`,`classifications`,`tags`,`list`],summary:`List Classification Tags`,description:`Returns a paginated list of editorial tags and standardized classifications. Filter by category using any bucket or standardized category spelling listed by the catalog, and by name with q. Sorting is not supported — sort returns 422.`,scope:`read`,auth:`bearer`,errorResponse:[],parameters:[{name:`category`,optionKey:`category`,flag:`--category <category>`,required:!1,description:`Classification bucket or standardized category. Case- and punctuation-insensitive.`,schemaType:`string`,location:`query`},{name:`q`,optionKey:`q`,flag:`--q <q>`,required:!1,description:`Case-insensitive name substring filter (e.g. 'enterprise').`,schemaType:`string`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`25`,location:`query`}]},{operationId:`listEntityContentFacets`,method:`GET`,path:`/v1/entities/{entityId}/content/facets`,resource:`entities`,intent:`read`,cliPath:[`entities`,`content`,`facets`,`list`],summary:`Count a Company's Publications`,description:`Counts one entity's content cards by topic and content type across the whole index, so filters show exact totals before every page loads. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`PublicationFacet`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity UUID whose publications are counted.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listEntityRelationshipTypes`,method:`GET`,path:`/v1/entities/relationships/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`relationships`,`types`,`list`],summary:`List Entity Relationship Types`,description:`Returns canonical EntityRelationshipType values, aliases, and policy flags. Use joinable=true values with entities relationships create; acquisitionManaged=true values route through entity acquisitions; exclusiveRelationshipType lists relationship types that cannot coexist for the same unordered entity pair; readOnly=true values are emitted by reads only.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`EntityRelationshipTypeOption`,parameters:[]},{operationId:`listEntityResearchDetailTypes`,method:`GET`,path:`/v1/entities/research-details/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-details`,`types`,`list`],summary:`List the Accepted Research Detail Types`,description:`Returns research detail type tokens and their write metadata. The metadata includes valueShape, allowedToken, range, and timeSeries. When timeSeries=true, each believable dated observation is historical data: add a new current row and delete only rows believed false.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`ResearchDetailType`,parameters:[]},{operationId:`listEntityResearchSnippetTypes`,method:`GET`,path:`/v1/entities/research-snippets/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`research-snippets`,`types`,`list`],summary:`List the Accepted Research Snippet Types`,description:`Lists the recognized research snippet types. A textType in this list is validated against its length and paragraph rules on write and defaults to visible; a textType not in this list is still saved but defaults to visible=false (hidden from default reads). The per-row visible flag overrides the default either way. The curated and analysisRenderable flags mark public Analysis-page eligibility, not snippet display.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`ResearchSnippetType`,parameters:[]},{operationId:`listEntitySimilarSummaries`,method:`GET`,path:`/v1/entities/{entityId}/similar/summary`,resource:`entities`,intent:`read`,cliPath:[`entities`,`similar`,`summary`,`list`],summary:`Get Similar Company Summaries by ID`,description:`Returns the same similar entities, order, and totals as GET /v1/entities/{entityId}/similar with lean rows: entity core, current URL links, and similarity provenance. Use it for rails and cards that do not render list enrichment. Custom sorting is unsupported. Any signed-in user may call this on every plan. The list is free: it never counts against the monthly record-view allowance, which charges only a separate full-detail view of one record.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`EntitySimilaritySummary`,parameters:[{name:`entityId`,optionKey:`entityId`,flag:`--entity-id <uuid>`,required:!0,description:`Entity unique identifier (UUID).`,schemaType:`string`,schemaFormat:`uuid`,location:`path`},{name:`relationshipType`,optionKey:`relationshipType`,flag:`--relationship-type <relationship-type>`,required:!1,description:`Filter by stored relationship type, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor.`,schemaType:`string`,location:`query`},{name:`typeRecord`,optionKey:`typeRecord`,flag:`--type-record <type-record...>`,required:!1,description:`Optional entity typeRecord filter. Repeat to allow multiple entity types.`,schemaType:`array`,itemSchemaType:`string`,location:`query`},{name:`permitMonogram`,optionKey:`permitMonogram`,flag:`--permit-monogram [true|false]`,required:!1,description:`Permit monogram fallback.`,schemaType:`boolean`,location:`query`},{name:`page`,optionKey:`page`,flag:`--page <integer>`,required:!1,description:`Zero-based page index (0..N).`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`0`,location:`query`},{name:`size`,optionKey:`size`,flag:`--size <integer>`,required:!1,description:`The size of the page to be returned.`,schemaType:`integer`,schemaFormat:`int32`,defaultValue:`10`,location:`query`}]},{operationId:`listEntityTextTypes`,method:`GET`,path:`/v1/entities/texts/types`,resource:`entities`,intent:`read`,cliPath:[`entities`,`texts`,`types`,`list`],summary:`List the Accepted Company Text Types`,description:`Returns text type values accepted by entity text rows.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`TextTypeOption`,parameters:[]},{operationId:`sendNewsSubscriptionTestEvent`,method:`POST`,path:`/v1/news/subscriptions/{subscriptionId}/test-events`,resource:`news`,intent:`write`,cliPath:[`news`,`subscriptions`,`test-events`,`send`],summary:`Send a Test News Event`,description:`POSTs one signed sample entity.news.published event to the caller's subscription url and returns the receiver's HTTP status. The cursor and retry state do not change. An unanswered POST answers 422 with its callback_* code.`,scope:`write`,auth:`bearer`,errorResponse:[],successResponse:`NewsSubscriptionTestEvent`,parameters:[{name:`subscriptionId`,optionKey:`subscriptionId`,flag:`--subscription-id <subscription-id>`,required:!0,description:`Subscription id from subscribe or list.`,schemaType:`string`,location:`path`}]},{operationId:`listPersonContentFacets`,method:`GET`,path:`/v1/people/{personId}/content/facets`,resource:`people`,intent:`read`,cliPath:[`people`,`content`,`facets`,`list`],summary:`Count a Person's Publications`,description:`Counts one person's content cards by topic and content type across the whole index, so filters show exact totals before every page loads. Any signed-in user may call this.`,scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`PublicationFacet`,parameters:[{name:`personId`,optionKey:`personId`,flag:`--person-id <uuid>`,required:!0,description:`Person UUID whose publications are counted.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`listPersonTextTypes`,method:`GET`,path:`/v1/people/texts/types`,resource:`people`,intent:`read`,cliPath:[`people`,`texts`,`types`,`list`],summary:`List the Accepted Person Text Types`,description:`Returns text type values accepted by person text rows.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`TextTypeOption`,parameters:[]},{operationId:`getLinkSearchJob`,method:`GET`,path:`/v1/search/link/jobs/{jobId}`,resource:`search`,intent:`read`,cliPath:[`search`,`link`,`jobs`,`get`],summary:`Get a Link Search Job`,description:"Returns the result of a link search accepted with `Prefer: respond-async`. Answers 202 with Location and Retry-After while the job is pending or running, 200 with the search once it completes, the synchronous read's 404 or 422 when the page or URL was refused, and 503 when the job failed transiently; resubmit the search to retry. Runs and their stored results do not expire; an unknown job id returns 404.",scope:`read`,auth:`bearer`,errorResponse:[{status:`402`,description:`This search needs a paid aVenture plan; a caller without one gets 402 with code subscription_required.`}],successResponse:`LinkSearch`,parameters:[{name:`jobId`,optionKey:`jobId`,flag:`--job-id <uuid>`,required:!0,description:`Link search job UUID.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]},{operationId:`getSharedSearchBySlug`,method:`GET`,path:`/v1/search/shared/slug/{slug}`,resource:`search`,intent:`read`,cliPath:[`search`,`shared`,`slug`,`get`],summary:`Read a Shared Search by Slug`,description:`Resolves the saved query slug used by the public search page.`,scope:`read`,auth:`none`,errorResponse:[],successResponse:`SharedSearch`,parameters:[{name:`slug`,optionKey:`recordSlug`,flag:`--record-slug <record-slug>`,required:!0,description:`Shared search slug.`,schemaType:`string`,location:`path`}]},{operationId:`getWebSearchJob`,method:`GET`,path:`/v1/web/searches/jobs/{jobId}`,resource:`web`,intent:`read`,cliPath:[`web`,`searches`,`jobs`,`get`],summary:`Get an Async Web Search Job`,description:"Reads the web-search job a `Prefer: respond-async` search accepted. Answers 200 with the finished search (charged like a search), 202 with Retry-After while the search is queued or running, 503 search_provider_error when the job ended without a result (run the search again), and 404 for an unknown job. Never starts or resubmits a provider search.",scope:`read`,auth:`bearer`,errorResponse:[],successResponse:`WebSearch`,detailField:[`answerBox`,`knowledgeGraph`,`relatedQuestion`,`relatedSearch`,`sportsResult`],parameters:[{name:`jobId`,optionKey:`jobId`,flag:`--job-id <uuid>`,required:!0,description:`Web-search job UUID from the 202 response.`,schemaType:`string`,schemaFormat:`uuid`,location:`path`}]}];export{e as n,t};