--- title: "Fetch Businesses" method: POST path: "/v1/businesses" tags: ["Businesses"] --- # Fetch Businesses `POST /v1/businesses` Filters businesses by country, company size, revenue, and more. Returns minimal data needed for further filtering, deduplication, or record previews. ## Headers - `tenant` string ## Request body - BusinessesFetchRequest - `request_context` object, nullable - `mode` 'full' | 'preview', required — The `BaseFetchMode` class is an enumeration that defines the modes for fetching data. This enum is used to specify whether the fetch operation should retrieve the full data or just a preview of the data. It ensures consistent handling of fetch modes across the application. Attributes: FULL: Fetch the complete data. PREVIEW: Fetch a preview or partial data. - `size` integer, required — The maximum number of businesses to return. Max size is 60000 - `page_size` integer, required — The maximum number of businesses in a page. Max limit is 500 - `page` integer, nullable — The page number to fetch. - `exclude` string[], nullable — List of business ids to exclude from the response. - `filters` BusinessesFetchFilters - `country_code` IncludesFilterCountryCodeAlpha2 - `negate` boolean - `values` string[], required - `region_country_code` IncludesFilterRegionCode - `negate` boolean - `values` string[], required - `company_size` IncludesFilterNumberOfEmployeesRange - `negate` boolean - `values` NumberOfEmployeesRange[], required - `company_revenue` IncludesFilterRevenueRange - `negate` boolean - `values` RevenueRange[], required - `company_age` IncludesFilterCompanyAgeRange - `negate` boolean - `values` CompanyAgeRange[], required - `google_category` IncludesFilterStandardizedText - `negate` boolean - `values` string[], required - `naics_category` IncludesFilterNAICS - `negate` boolean - `values` string[], required - `linkedin_category` IncludesFilterStandardizedText - `negate` boolean - `values` string[], required - `company_tech_stack_category` IncludesFilterText - `negate` boolean - `values` string[], required - `company_tech_stack_tech` IncludesFilterText - `negate` boolean - `values` string[], required - `company_name` DynamicIncludesFilterOrganizationName - `negate` boolean - `values` string[], required - `number_of_locations` IncludesFilterNumberOfLocations - `negate` boolean - `values` NumberOfLocations[], required - `city_region_country` IncludesFilterText - `negate` boolean - `values` string[], required - `city_region` IncludesFilterText - `negate` boolean - `values` string[], required - `website_keywords` AnyMatchPhraseFilterText - `negate` boolean - `values` string[], required - `business_intent_topics` BusinessIntentTopicsFilter - `negate` boolean - `topics` string[], required - `topic_intent_level` 'emerging_intent' | 'high_intent' | 'very_high_intent' — An enumeration. - `events` EventTypesFilterBusinessesEventIdentifier - `negate` boolean - `values` BusinessesEventIdentifier[], required - `last_occurrence` integer, required — Filter events that occurred within the last N days (required) - `has_website` ExistsFilter - `negate` boolean - `value` boolean, required - `is_public_company` ExistsFilter - `negate` boolean - `value` boolean, required - `next_cursor` string, nullable — The sort values from the last document returned by the previous page. If provided, cursor pagination is used instead of page-based pagination. send "null" to start with next_cursor pagination from the beginning. ## Response `200` Successful Response - union - BusinessesFetchResponse — This is base response model for all responses in partner service. - `response_context` ResponseContext, required - `correlation_id` string, required - `request_status` 'success' | 'miss' | 'failure', required — The `RequestStatus` class is an enumeration that defines the possible statuses of a request. This enum is used to indicate whether a request was successful, missed, or failed. It ensures consistent handling of request statuses across the application. Attributes: SUCCESS: Indicates that the request was successfully processed. MISS: Indicates that the request did not find any matching data. FAILURE: Indicates that the request encountered an error or failure. - `time_took_in_seconds` number, required - `data` Business[] — List of businesses that match the filters. - `business_id` string, required - `name` string, required - `domain` string - `logo` string - `country_name` string - `city_name` string - `number_of_employees_range` '1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10001+' — The `NumberOfEmployeesRange` class is an enumeration that represents predefined ranges for the number of employees in a company. These ranges are used for filtering and categorizing companies based on their workforce size. - `yearly_revenue_range` '0-500K' | '500K-1M' | '1M-5M' | '5M-10M' | '10M-25M' | '25M-75M' | '75M-200M' | '200M-500M' | '500M-1B' | '1B-10B' | '10B-100B' | '100B-1T' | '1T-10T' | '10T+' — The `RevenueRange` class is an enumeration that represents predefined ranges for the revenue of a company. - `website` string - `business_description` string - `region` string - `naics` integer - `naics_description` string - `sic_code` string - `sic_code_description` string - `business_intent_topics` object[] - `events` string[] - `total_results` integer — The total number of businesses that match the filters. - `page` integer — The page number of the response. - `total_pages` integer, required — The total number of pages. - BusinessesFetchResponseV2 — This is base response model for all responses in partner service. - `response_context` ResponseContext, required - `correlation_id` string, required - `request_status` 'success' | 'miss' | 'failure', required — The `RequestStatus` class is an enumeration that defines the possible statuses of a request. This enum is used to indicate whether a request was successful, missed, or failed. It ensures consistent handling of request statuses across the application. Attributes: SUCCESS: Indicates that the request was successfully processed. MISS: Indicates that the request did not find any matching data. FAILURE: Indicates that the request encountered an error or failure. - `time_took_in_seconds` number, required - `data` Business[] — List of businesses that match the filters. - `business_id` string, required - `name` string, required - `domain` string - `logo` string - `country_name` string - `city_name` string - `number_of_employees_range` '1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10001+' — The `NumberOfEmployeesRange` class is an enumeration that represents predefined ranges for the number of employees in a company. These ranges are used for filtering and categorizing companies based on their workforce size. - `yearly_revenue_range` '0-500K' | '500K-1M' | '1M-5M' | '5M-10M' | '10M-25M' | '25M-75M' | '75M-200M' | '200M-500M' | '500M-1B' | '1B-10B' | '10B-100B' | '100B-1T' | '1T-10T' | '10T+' — The `RevenueRange` class is an enumeration that represents predefined ranges for the revenue of a company. - `website` string - `business_description` string - `region` string - `naics` integer - `naics_description` string - `sic_code` string - `sic_code_description` string - `business_intent_topics` object[] - `events` string[] - `total_results` integer — The total number of businesses that match the filters. - `page` PartnerServiceModelsServicesRequestsPageInfo, required - `size` integer, required — Number of results in this page - `next_cursor` string — Cursor for pagination. Use this value as cursor in the next request. ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/vibeprospecting/apis/partner-service.md) · [All operations](https://skmtc.net/vibeprospecting/apis/partner-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vibeprospecting/partner-service/versions/1699f3c803f7/schema)