> ## Documentation Index > Fetch the complete documentation index at: https://docs.companyenrich.com/llms.txt > Use this file to discover all available pages before exploring further. # Search people > Search people using person filters, a natural-language query, and an optional company query. **Cost:** 2 credits per returned person, plus requested paid expansions. Empty results cost one result's base price. The `education` expansion adds 1 credit per returned person. Repeating an expansion does not multiply its cost. The `company` expansion includes the standard company profile in `experiences[].company` for current and past experiences. It adds 1 credit per unique company successfully expanded across this response page, even when multiple people or experiences reference it. Unavailable companies retain their summary without an expansion charge. Companies on another page or request are charged again. Separately priced company expansions are not included. Company expansion supports at most 500 unique available companies per response page. A page exceeding this limit returns `400` before company profiles are loaded or credits are charged. Reduce `pageSize` or remove `company` from `expand` and retry. Person filters can be combined with a company query to find people whose current companies match. The company query accepts the same filters, semantic query, and lookalike seeds as company search. Company queries that use `query`, keyword, technology, funding, workforce, `reportedEmployees`, or required-feature filters, or a semantic or lookalike query, match people at the 1,000 best-matching companies. A semantic query infers person filters and a description of the current companies. For example, `VP of sales at Series A SaaS startups in Germany` filters VP-level sales people and searches their current companies with the semantic company query `Series A SaaS startups in Germany`. Inferred person names, positions, seniorities, departments, countries, current and past companies, schools, and recent company or position start dates filter results. Person locations are inferred at country level, so a city filters its country. Current company names and confidently equivalent aliases are OR alternatives in a company text query, matching names, keywords, and domain prefixes before finding current employees. Past company names resolve to domains. Request filters that include values take precedence over inferred values of the same kind, and request exclusions apply together with inferred values. A request `company.semantic` or `company.lookalike` query replaces the inferred company description. When the request includes specific current companies by id, domain, or LinkedIn handle in `filter`, or by id, domain, or query inclusions in `company.filter`, current companies are not inferred. A semantic query from which no filters can be inferred is rejected. The response `interpretation` reports what was inferred. Top-level company, seniority, department, position, and start date filters match current experiences. Use `filter.pastExperience` to find people by previous employment. Its inclusion rules must all match the same past experience, and people who still work at an included company are excluded. A past company exclusion removes people with any matching past experience. Past seniority, department, and position filters do not support exclusions. Send an empty object (`{}`) to search without filters. Results use cursor pagination. Omit `cursor` for the first page and pass a cursor returned by the previous response to continue. Numbered pagination is not supported. Keep the same query when continuing a search. Cursors expire 24 hours after the first page. Experiences that matched the search filters are marked with `isMatched`. A value filter supports these input forms: - match one value: `"TR"` - match several values: `["TR", "US"]` - configure advanced matching rules: `{ "in": ["TR"], "notIn": ["US"] }` A single value or array matches any provided value. Use the object form to configure inclusion and exclusion rules together. Exclusions on current-experience fields (company, seniority, department, and position) remove a person when any of their current experiences matches. ## OpenAPI ````yaml openapi/v2.json POST /v2/people/search openapi: 3.0.4 info: title: Company Enrich API v2 description: >- The Company Enrich API v2 provides programmatic access to company and person data for enrichment, search, and lead generation. ## Key Features - **Company Enrichment** — Enrich company profiles by domain or identifying properties, and retrieve stored companies by ID. - **Company Search** — Search and filter companies with cursor pagination, counts, and previews. - **Semantic and Lookalike Search** — Find companies using natural-language queries or similar company domains. - **People Enrichment** — Retrieve people by ID, identify people from their email address, and find work email addresses. - **People Search** — Search people by position, seniority, department, location, education, and company with cursor pagination, counts, and previews. - **Reference Data** — Look up industries, geographic data, keywords, technologies, and job titles. V2 intentionally excludes saved company lists, list-based exports, and filtering searches by saved-list IDs. These features remain available in V1 and are not planned for V2. ## Authentication All API requests require a Bearer token passed in the `Authorization` header: ``` Authorization: Bearer YOUR_API_TOKEN ``` You can generate API tokens from your [dashboard](https://companyenrich.com/dashboard). ## Credits Most API calls consume credits. The credit cost for each endpoint is documented in its description. You can check your remaining credit balance using the User endpoint. ## Rate Limiting The global API limiter allows **500 requests per minute** per IP address. Authenticated API routes also use a per-user route limiter based on plan capabilities. Supplementary lookup endpoints (such as keyword/technology/industry autocompletes) use a separate per-user route-level bucket. termsOfService: https://companyenrich.com/terms-and-conditions contact: url: https://companyenrich.com/ email: support@companyenrich.com version: 2.0.0 servers: - url: https://api.companyenrich.com security: - Bearer: [] tags: - name: Company / Enrichment description: >- Enrich company data by domain, properties, or in batch. Get company details by ID. - name: Company / Bulk Enrichment description: >- Create and manage asynchronous bulk enrichment jobs for large domain lists. - name: Company / Search description: Search companies by filters with pagination and cursor scrolling. - name: People / Search description: >- Search people by various criteria with page-based or cursor-based pagination. - name: People / Enrichment description: >- Resolve work email addresses for individual people in realtime or background jobs. - name: Geo description: >- Endpoints for looking up geographic data including regions, countries, states, and cities. - name: Industries description: >- Endpoints for listing available industry classifications used in company search filters. - name: Keywords description: Endpoints for looking up keywords used in company search filters. - name: Technologies description: Endpoints for looking up technologies used in company search filters. - name: User description: >- Endpoints for retrieving information about the authenticated user, including credit balance and account details. - name: Positions description: Endpoints for looking up job positions and titles. paths: /v2/people/search: post: tags: - People / Search summary: Search people description: >- Search people using person filters, a natural-language query, and an optional company query. **Cost:** 2 credits per returned person, plus requested paid expansions. Empty results cost one result's base price. The `education` expansion adds 1 credit per returned person. Repeating an expansion does not multiply its cost. The `company` expansion includes the standard company profile in `experiences[].company` for current and past experiences. It adds 1 credit per unique company successfully expanded across this response page, even when multiple people or experiences reference it. Unavailable companies retain their summary without an expansion charge. Companies on another page or request are charged again. Separately priced company expansions are not included. Company expansion supports at most 500 unique available companies per response page. A page exceeding this limit returns `400` before company profiles are loaded or credits are charged. Reduce `pageSize` or remove `company` from `expand` and retry. Person filters can be combined with a company query to find people whose current companies match. The company query accepts the same filters, semantic query, and lookalike seeds as company search. Company queries that use `query`, keyword, technology, funding, workforce, `reportedEmployees`, or required-feature filters, or a semantic or lookalike query, match people at the 1,000 best-matching companies. A semantic query infers person filters and a description of the current companies. For example, `VP of sales at Series A SaaS startups in Germany` filters VP-level sales people and searches their current companies with the semantic company query `Series A SaaS startups in Germany`. Inferred person names, positions, seniorities, departments, countries, current and past companies, schools, and recent company or position start dates filter results. Person locations are inferred at country level, so a city filters its country. Current company names and confidently equivalent aliases are OR alternatives in a company text query, matching names, keywords, and domain prefixes before finding current employees. Past company names resolve to domains. Request filters that include values take precedence over inferred values of the same kind, and request exclusions apply together with inferred values. A request `company.semantic` or `company.lookalike` query replaces the inferred company description. When the request includes specific current companies by id, domain, or LinkedIn handle in `filter`, or by id, domain, or query inclusions in `company.filter`, current companies are not inferred. A semantic query from which no filters can be inferred is rejected. The response `interpretation` reports what was inferred. Top-level company, seniority, department, position, and start date filters match current experiences. Use `filter.pastExperience` to find people by previous employment. Its inclusion rules must all match the same past experience, and people who still work at an included company are excluded. A past company exclusion removes people with any matching past experience. Past seniority, department, and position filters do not support exclusions. Send an empty object (`{}`) to search without filters. Results use cursor pagination. Omit `cursor` for the first page and pass a cursor returned by the previous response to continue. Numbered pagination is not supported. Keep the same query when continuing a search. Cursors expire 24 hours after the first page. Experiences that matched the search filters are marked with `isMatched`. A value filter supports these input forms: - match one value: `"TR"` - match several values: `["TR", "US"]` - configure advanced matching rules: `{ "in": ["TR"], "notIn": ["US"] }` A single value or array matches any provided value. Use the object form to configure inclusion and exclusion rules together. Exclusions on current-experience fields (company, seniority, department, and position) remove a person when any of their current experiences matches. requestBody: content: application/json: schema: $ref: '#/components/schemas/PersonSearchV2Request' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PersonSearchV2Response' '400': description: Bad Request content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '401': description: Unauthorized content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '402': description: Payment Required content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '403': description: Forbidden content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '422': description: Unprocessable Entity content: application/problem+json: schema: $ref: '#/components/schemas/HttpValidationProblemDetails' '429': description: Too Many Requests content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' components: schemas: PersonSearchV2Request: type: object properties: pageSize: maximum: 100 minimum: 1 type: integer description: The maximum number of people to return format: int32 cursor: maxLength: 1024 type: string description: >- An opaque cursor returned by a previous search response. Omit for the first page. nullable: true expand: type: array items: enum: - education - company type: string description: >- Additional person data to include, charged on top of the base cost. Repeating an expansion does not multiply its cost: - `education`: 1 credit per returned person. - `company`: 1 credit per unique company successfully expanded across the returned current and past experiences. Includes the standard company profile; separately priced company expansions are not included. Unavailable companies retain their summary without an expansion charge. Search charges each company once per response page. Limited to 500 unique available companies per request; exceeding the limit returns `400` without charging credits. Reduce `pageSize` for searches or remove `company` from `expand`. nullable: true filter: $ref: '#/components/schemas/PersonSearchFilter' semantic: $ref: '#/components/schemas/PersonSemanticQuery' company: $ref: '#/components/schemas/CompanySearchQuery' PersonSearchV2Response: required: - items type: object properties: items: type: array items: $ref: '#/components/schemas/PersonResponse' description: The people returned for this page nextCursor: type: string description: >- An opaque cursor for the next page. Omitted when there are no more results. nullable: true interpretation: $ref: '#/components/schemas/PersonSemanticInterpretationResponse' ProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true HttpValidationProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true errors: type: object additionalProperties: type: array items: type: string PersonSearchFilter: type: object properties: query: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- Queries matching person names. A string or array matches any query. Inclusions use OR; exclusions remove matches. Each entry supports the existing text query syntax, up to 250 characters. A blank string is treated as no query; blank entries in arrays or matching rules are invalid. Provide a single value, multiple values, or advanced matching rules. nullable: true companyId: oneOf: - title: Single value type: string description: Include results that match this value. format: uuid - title: Multiple values minItems: 1 type: array items: type: string format: uuid description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string format: uuid description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string format: uuid description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The current company ids to match. A single value or array matches any provided id. Provide a single value, multiple values, or advanced matching rules. nullable: true domain: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The current company domains to match, up to 2,500 per rule. A single value or array matches any provided domain. Provide a single value, multiple values, or advanced matching rules. nullable: true companyLinkedinHandle: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The current company LinkedIn handles or URLs to match. A single value or array matches any provided handle. Provide a single value, multiple values, or advanced matching rules. nullable: true seniority: oneOf: - title: Single value enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The current seniority levels to match. A single value or array matches any provided seniority. Provide a single value, multiple values, or advanced matching rules. nullable: true department: oneOf: - title: Single value enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - >- engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - >- engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - >- engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The current departments to match, including their sub-departments. A single value or array matches any provided department. Provide a single value, multiple values, or advanced matching rules. nullable: true country: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The country codes to match. A single value or array matches any provided country. Provide a single value, multiple values, or advanced matching rules. nullable: true position: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The phrases to match against current positions or titles. A single value or array matches any provided phrase. Provide a single value, multiple values, or advanced matching rules. nullable: true currentCompanyStartDate: $ref: '#/components/schemas/DateRangeFilter' currentPositionStartDate: $ref: '#/components/schemas/DateRangeFilter2' education: $ref: '#/components/schemas/PersonEducationSearchFilter' pastExperience: $ref: '#/components/schemas/PersonPastExperienceSearchFilter' description: The filters to apply to the people search nullable: true PersonSemanticQuery: required: - query type: object properties: query: maxLength: 500 type: string description: >- The natural-language query used to find people, such as `marketing leaders at Series B fintech startups in London`. Person names, positions, seniorities, departments, countries, current and past companies, schools, and recent company or position start dates are inferred as filters, and the current companies it describes are searched with a semantic company query. Attributes the request includes values for are not inferred. The response `interpretation` reports inferred values. description: >- The natural-language query used to infer person filters and the current companies nullable: true CompanySearchQuery: type: object properties: filter: $ref: '#/components/schemas/CompanySearchFilter' semantic: $ref: '#/components/schemas/CompanySemanticQuery' lookalike: $ref: '#/components/schemas/CompanyLookalikeQuery' description: The company query used to find people whose current companies match nullable: true PersonResponse: required: - id - socials - experiences type: object properties: id: type: integer description: The CompanyEnrich ID of the person format: int64 name: type: string description: The full name of the person nullable: true firstName: type: string description: The first name of the person nullable: true lastName: type: string description: The last name of the person nullable: true imageUrl: type: string description: The person image URL nullable: true position: type: string description: The person's current position or title nullable: true seniority: $ref: '#/components/schemas/NullableOfPersonSeniority' department: $ref: '#/components/schemas/NullableOfPersonDepartment' location: $ref: '#/components/schemas/PersonLocationResponse' socials: $ref: '#/components/schemas/PersonSocialsResponse' experiences: type: array items: $ref: '#/components/schemas/PersonExperienceResponse' description: The person's work experience updatedAt: type: string description: When the person data was last updated format: date-time nullable: true education: type: array items: $ref: '#/components/schemas/PersonEducationResponse' description: >- The person's education history. Included when `education` is requested in `expand`. nullable: true PersonSemanticInterpretationResponse: type: object properties: companyNames: type: array items: type: string description: >- Current employer names and aliases inferred from the query. These are applied as OR alternatives through company.filter.query, matching company names, keywords, and domain prefixes before resolving current employers. Omitted when explicit employer ids, domains, LinkedIn handles, or company query inclusions take precedence. This is interpretation output, not a request filter. nullable: true filter: $ref: '#/components/schemas/PersonSearchFilter2' company: $ref: '#/components/schemas/PersonSemanticCompanyInterpretationResponse' description: How the semantic query was interpreted. Present for semantic queries. nullable: true DateRangeFilter: type: object properties: after: type: string description: Include results after this date (inclusive) format: date-time nullable: true before: type: string description: Include results before this date (inclusive) format: date-time nullable: true description: The date range in which people joined their current company nullable: true DateRangeFilter2: type: object properties: after: type: string description: Include results after this date (inclusive) format: date-time nullable: true before: type: string description: Include results before this date (inclusive) format: date-time nullable: true description: The date range in which people started their current position nullable: true PersonEducationSearchFilter: type: object properties: institutionLinkedinHandle: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The education institution LinkedIn handles or URLs to match. A single value or array matches any provided handle. Provide a single value, multiple values, or advanced matching rules. nullable: true institutionName: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The phrases to match against education institution names. A single value or array matches any provided phrase. Provide a single value, multiple values, or advanced matching rules. nullable: true description: The education history filters to apply nullable: true PersonPastExperienceSearchFilter: type: object properties: companyId: oneOf: - title: Single value type: string description: Include results that match this value. format: uuid - title: Multiple values minItems: 1 type: array items: type: string format: uuid description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string format: uuid description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string format: uuid description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The past company ids to match. A single value or array matches any provided id. Provide a single value, multiple values, or advanced matching rules. nullable: true domain: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The past company domains to match. A single value or array matches any provided domain. Provide a single value, multiple values, or advanced matching rules. nullable: true companyLinkedinHandle: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The past company LinkedIn handles or URLs to match. A single value or array matches any provided handle. Provide a single value, multiple values, or advanced matching rules. nullable: true seniority: oneOf: - title: Single value enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The seniority levels to match in the past experience. A single value or array matches any provided seniority. Exclusions are not supported. Provide a single value, multiple values, or advanced matching rules. nullable: true department: oneOf: - title: Single value enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - >- engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - >- engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - >- engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The departments to match in the past experience, including their sub-departments. A single value or array matches any provided department. Exclusions are not supported. Provide a single value, multiple values, or advanced matching rules. nullable: true position: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The phrases to match against the past position or title. A single value or array matches any provided phrase. Exclusions are not supported. Provide a single value, multiple values, or advanced matching rules. nullable: true startDate: $ref: '#/components/schemas/DateRangeFilter3' endDate: $ref: '#/components/schemas/DateRangeFilter4' description: The past experience filters to apply nullable: true CompanySearchFilter: type: object properties: query: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- Queries matching company names, keywords, or domain prefixes. A string or array matches any query. Inclusions use OR; exclusions remove matches. Each entry supports the existing text query syntax, up to 250 characters. A blank string is treated as no query; blank entries in arrays or matching rules are invalid. Provide a single value, multiple values, or advanced matching rules. nullable: true id: oneOf: - title: Single value type: string description: Include results that match this value. format: uuid - title: Multiple values minItems: 1 type: array items: type: string format: uuid description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string format: uuid description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string format: uuid description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The company ids to match. A single value or array matches any provided id. Provide a single value, multiple values, or advanced matching rules. nullable: true domain: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The company domains to match. A single value or array matches any provided domain. Provide a single value, multiple values, or advanced matching rules. nullable: true keywords: oneOf: - title: Single value type: string description: Only match when this value matches the target. - title: Multiple values minItems: 1 type: array items: type: string description: Only match when every provided value matches the target. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values all: minItems: 1 type: array items: type: string description: >- Only match when every provided value is present in the target collection additionalProperties: false description: >- Configure values that may match, must all match, or must be excluded. description: >- The keywords to match. A single value or array requires every provided keyword. Provide a single value, multiple values, or advanced matching rules. nullable: true technologies: oneOf: - title: Single value type: string description: Only match when this value matches the target. - title: Multiple values minItems: 1 type: array items: type: string description: Only match when every provided value matches the target. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values all: minItems: 1 type: array items: type: string description: >- Only match when every provided value is present in the target collection additionalProperties: false description: >- Configure values that may match, must all match, or must be excluded. description: >- The technologies to match. A single value or array requires every provided technology. Provide a single value, multiple values, or advanced matching rules. nullable: true region: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The regions to match. A single value or array matches any provided region. Provide a single value, multiple values, or advanced matching rules. nullable: true country: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The countries to match. A single value or array matches any provided country. Provide a single value, multiple values, or advanced matching rules. nullable: true state: oneOf: - title: Single value type: integer description: Include results that match this value. format: int32 - title: Multiple values minItems: 1 type: array items: type: integer format: int32 description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: integer format: int32 description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: integer format: int32 description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The state ids to match. A single value or array matches any provided id. Provide a single value, multiple values, or advanced matching rules. nullable: true city: oneOf: - title: Single value type: integer description: Include results that match this value. format: int32 - title: Multiple values minItems: 1 type: array items: type: integer format: int32 description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: integer format: int32 description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: integer format: int32 description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The city ids to match. A single value or array matches any provided id. Provide a single value, multiple values, or advanced matching rules. nullable: true type: oneOf: - title: Single value enum: - private - public - self-employed - self-owned - partnership - nonprofit - educational - government type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - private - public - self-employed - self-owned - partnership - nonprofit - educational - government type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - private - public - self-employed - self-owned - partnership - nonprofit - educational - government type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - private - public - self-employed - self-owned - partnership - nonprofit - educational - government type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The company types to match. A single value or array matches any provided type. Provide a single value, multiple values, or advanced matching rules. nullable: true employees: oneOf: - title: Single value enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The employee ranges to match. A single value or array matches any provided range. Provide a single value, multiple values, or advanced matching rules. nullable: true reportedEmployees: oneOf: - title: Single value enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The externally reported employee ranges to match. A single value or array matches any provided range. Provide a single value, multiple values, or advanced matching rules. nullable: true revenue: oneOf: - title: Single value enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The revenue ranges to match. A single value or array matches any provided range. Provide a single value, multiple values, or advanced matching rules. nullable: true workforceGrowth: $ref: '#/components/schemas/CompanyWorkforceGrowthV2Filter' workforceSize: type: array items: $ref: '#/components/schemas/CompanyWorkforceSizeV2Filter' description: The workforce headcount ranges of companies, by department nullable: true naicsCodes: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values all: minItems: 1 type: array items: type: string description: >- Only match when every provided value is present in the target collection additionalProperties: false description: >- Configure values that may match, must all match, or must be excluded. description: >- The NAICS code strings to match, each containing 2 to 6 ASCII digits without a leading zero. Surrounding whitespace is ignored. A single value or array matches any provided code. Provide a single value, multiple values, or advanced matching rules. nullable: true categories: oneOf: - title: Single value enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business type: string description: Only match when this value matches the target. - title: Multiple values minItems: 1 type: array items: enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business type: string description: Only match when every provided value matches the target. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business type: string description: >- Exclude results when the target value is one of the provided values all: minItems: 1 type: array items: enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business type: string description: >- Only match when every provided value is present in the target collection additionalProperties: false description: >- Configure values that may match, must all match, or must be excluded. description: >- The categories to match. A single value or array requires every provided category. Provide a single value, multiple values, or advanced matching rules. nullable: true foundedYear: $ref: '#/components/schemas/YearRangeFilter' fundingRounds: oneOf: - title: Single value enum: - seed - debt_financing - angel - venture - series_a - series_b - series_c - series_d - series_e - series_f - series_g - series_h - other type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - seed - debt_financing - angel - venture - series_a - series_b - series_c - series_d - series_e - series_f - series_g - series_h - other type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - seed - debt_financing - angel - venture - series_a - series_b - series_c - series_d - series_e - series_f - series_g - series_h - other type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - seed - debt_financing - angel - venture - series_a - series_b - series_c - series_d - series_e - series_f - series_g - series_h - other type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The funding rounds to match. A single value or array matches any provided round. Provide a single value, multiple values, or advanced matching rules. nullable: true fundingAmount: $ref: '#/components/schemas/AmountRangeFilter' fundingYear: $ref: '#/components/schemas/YearRangeFilter2' require: oneOf: - title: Single value enum: - linkedin - twitter - facebook - instagram - angellist - crunchbase - youtube - country - city - state - revenue - foundedYear - anyFunding type: string description: Only match when this value matches the target. - title: Multiple values minItems: 1 type: array items: enum: - linkedin - twitter - facebook - instagram - angellist - crunchbase - youtube - country - city - state - revenue - foundedYear - anyFunding type: string description: Only match when every provided value matches the target. - title: Advanced matching rules minProperties: 1 type: object properties: all: minItems: 1 type: array items: enum: - linkedin - twitter - facebook - instagram - angellist - crunchbase - youtube - country - city - state - revenue - foundedYear - anyFunding type: string description: Only match when every provided value matches the target additionalProperties: false description: Configure values that must all match. description: >- The features companies must have. A single value or array requires every provided feature. Provide a single value, multiple values, or advanced matching rules. nullable: true description: The filters to apply to the company search nullable: true CompanySemanticQuery: required: - query type: object properties: query: maxLength: 500 type: string description: The natural-language query used to find companies weight: maximum: 1 minimum: 0 type: number description: >- The semantic relevance weight. Larger values prioritize semantic similarity. format: double nullable: true autoFilter: type: boolean description: >- Whether to infer company attributes such as location, size, and business model from the query. Defaults to true. Inferred location, employee, founded year, and funding values filter results; inferred company names, categories, and revenue rank matching companies higher. Attributes the request includes values for are not inferred; request exclusions apply together with inferred values. The response `interpretation` reports inferred values. nullable: true description: The semantic query used to find relevant companies nullable: true CompanyLookalikeQuery: required: - domains type: object properties: domains: maxItems: 10 minItems: 1 type: array items: type: string description: The seed company domains used to find lookalike companies weight: maximum: 1 minimum: -1 type: number description: >- The ranking weight for company similarity. Larger values prioritize more similar companies. format: double nullable: true minScore: maximum: 1 minimum: 0 type: number description: >- The minimum vector similarity required before lookalike ranking penalties are applied format: double nullable: true description: The seed companies used to find lookalike companies nullable: true NullableOfPersonSeniority: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern - null description: The person's current seniority level nullable: true NullableOfPersonDepartment: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant - null description: The person's current department nullable: true PersonLocationResponse: type: object properties: country: $ref: '#/components/schemas/PersonCountryResponse' address: type: string description: The person's reported location nullable: true description: The person location nullable: true PersonSocialsResponse: type: object properties: linkedinUrl: type: string description: The person LinkedIn URL nullable: true description: The person social profiles PersonExperienceResponse: required: - isCurrent - isMatched type: object properties: startDate: type: string description: The date the experience started format: date nullable: true endDate: type: string description: The date the experience ended format: date nullable: true isCurrent: type: boolean description: Whether this is a current experience isMatched: type: boolean description: Whether this experience matched the search filters position: type: string description: The position or title held during the experience nullable: true seniority: $ref: '#/components/schemas/NullableOfPersonSeniority2' department: $ref: '#/components/schemas/NullableOfPersonDepartment2' company: $ref: '#/components/schemas/PersonExperienceCompanyResponse' companyName: type: string description: The reported company name when no company record was matched nullable: true PersonEducationResponse: required: - institutionName type: object properties: institutionName: type: string description: The name of the educational institution institution: $ref: '#/components/schemas/PersonCompanyResponse' socialHandle: type: string description: The social media handle of the educational institution nullable: true degree: type: array items: type: string description: The degrees or fields of study associated with this education entry nullable: true startYear: type: integer description: The year this education entry started format: int16 nullable: true endYear: type: integer description: The year this education entry ended format: int16 nullable: true PersonSearchFilter2: type: object properties: query: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- Queries matching person names. A string or array matches any query. Inclusions use OR; exclusions remove matches. Each entry supports the existing text query syntax, up to 250 characters. A blank string is treated as no query; blank entries in arrays or matching rules are invalid. Provide a single value, multiple values, or advanced matching rules. nullable: true companyId: oneOf: - title: Single value type: string description: Include results that match this value. format: uuid - title: Multiple values minItems: 1 type: array items: type: string format: uuid description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string format: uuid description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string format: uuid description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The current company ids to match. A single value or array matches any provided id. Provide a single value, multiple values, or advanced matching rules. nullable: true domain: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The current company domains to match, up to 2,500 per rule. A single value or array matches any provided domain. Provide a single value, multiple values, or advanced matching rules. nullable: true companyLinkedinHandle: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The current company LinkedIn handles or URLs to match. A single value or array matches any provided handle. Provide a single value, multiple values, or advanced matching rules. nullable: true seniority: oneOf: - title: Single value enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The current seniority levels to match. A single value or array matches any provided seniority. Provide a single value, multiple values, or advanced matching rules. nullable: true department: oneOf: - title: Single value enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - >- engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - >- engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - >- engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The current departments to match, including their sub-departments. A single value or array matches any provided department. Provide a single value, multiple values, or advanced matching rules. nullable: true country: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The country codes to match. A single value or array matches any provided country. Provide a single value, multiple values, or advanced matching rules. nullable: true position: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The phrases to match against current positions or titles. A single value or array matches any provided phrase. Provide a single value, multiple values, or advanced matching rules. nullable: true currentCompanyStartDate: $ref: '#/components/schemas/DateRangeFilter' currentPositionStartDate: $ref: '#/components/schemas/DateRangeFilter2' education: $ref: '#/components/schemas/PersonEducationSearchFilter' pastExperience: $ref: '#/components/schemas/PersonPastExperienceSearchFilter' description: >- Person filters inferred from the query and applied together with the request filters, in the request filter format. Omitted when none were inferred. Attributes the request includes values for are not inferred. Recent company or position start dates are reported as date ranges starting on the first day of a month, since profile start dates have month precision. nullable: true PersonSemanticCompanyInterpretationResponse: required: - query type: object properties: query: type: string description: >- The company description inferred from the query. It is searched like a company `semantic.query` together with the request company filters. A description that does not say what the companies do, such as `startups with over $10M revenue`, applies its inferred filters without a semantic company search; inferred categories and revenue then filter companies instead of ranking them. filter: $ref: '#/components/schemas/CompanySearchFilter3' boost: $ref: '#/components/schemas/CompanySemanticBoostResponse2' description: >- The current companies described by the query. Omitted when the query does not describe them, the description adds no company filters, the request has a semantic or lookalike company query, or the request includes specific current companies. nullable: true DateRangeFilter3: type: object properties: after: type: string description: Include results after this date (inclusive) format: date-time nullable: true before: type: string description: Include results before this date (inclusive) format: date-time nullable: true description: The date range in which the past experience started nullable: true DateRangeFilter4: type: object properties: after: type: string description: Include results after this date (inclusive) format: date-time nullable: true before: type: string description: Include results before this date (inclusive) format: date-time nullable: true description: The date range in which the past experience ended nullable: true CompanyWorkforceGrowthV2Filter: type: object properties: period: $ref: '#/components/schemas/NullableOfCompanyWorkforceGrowthPeriod' department: $ref: '#/components/schemas/NullableOfCompanyWorkforceGrowthDepartment' min: type: number description: The minimum growth ratio (inclusive). 0.15 represents 15% growth. format: float nullable: true max: type: number description: The maximum growth ratio (inclusive). 0.15 represents 15% growth. format: float nullable: true description: The workforce growth ratio range of companies nullable: true CompanyWorkforceSizeV2Filter: type: object properties: department: $ref: '#/components/schemas/NullableOfCompanyWorkforceGrowthDepartment2' min: type: integer description: The minimum headcount (inclusive). format: int32 nullable: true max: type: integer description: The maximum headcount (inclusive). format: int32 nullable: true YearRangeFilter: type: object properties: min: type: integer description: The minimum value (inclusive) format: int32 nullable: true max: type: integer description: The maximum value (inclusive) format: int32 nullable: true description: The founded year range of companies nullable: true AmountRangeFilter: type: object properties: min: type: number description: The minimum value (inclusive) format: double nullable: true max: type: number description: The maximum value (inclusive) format: double nullable: true description: The funding amount range of companies nullable: true YearRangeFilter2: type: object properties: min: type: integer description: The minimum value (inclusive) format: int32 nullable: true max: type: integer description: The maximum value (inclusive) format: int32 nullable: true description: The latest funding year range of companies nullable: true PersonCountryResponse: required: - code - name type: object properties: code: type: string description: The ISO 3166-1 alpha-2 country code name: type: string description: The country name description: The country where the person is located nullable: true NullableOfPersonSeniority2: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern - null description: The seniority level associated with the experience nullable: true NullableOfPersonDepartment2: enum: - c-suite - c-suite/executive - c-suite/finance-executive - c-suite/founder - c-suite/human-resources-executive - c-suite/information-technology-executive - c-suite/legal-executive - c-suite/marketing-executive - c-suite/medical-health-executive - c-suite/operations-executive - c-suite/sales-executive - product-management - product-management/product-development - product-management/product-management - engineering-technical - engineering-technical/artificial-intelligence-machine-learning - engineering-technical/bioengineering - engineering-technical/biometrics - engineering-technical/business-intelligence - engineering-technical/chemical-engineering - engineering-technical/cloud-mobility - engineering-technical/data-science - engineering-technical/devops - engineering-technical/digital-transformation - engineering-technical/emerging-technology-innovation - engineering-technical/engineering-technical - engineering-technical/industrial-engineering - engineering-technical/mechanic - engineering-technical/mobile-development - engineering-technical/project-management - engineering-technical/research-development - engineering-technical/scrum-master-agile-coach - engineering-technical/software-development - engineering-technical/support-technical-services - engineering-technical/technician - engineering-technical/technology-operations - engineering-technical/test-quality-assurance - engineering-technical/ui-ux - engineering-technical/web-development - design - design/all-design - design/product-ui-ux-design - design/graphic-design - education - education/teacher - education/principal - education/superintendent - education/professor - finance - finance/accounting - finance/finance - finance/financial-planning-analysis - finance/financial-reporting - finance/financial-strategy - finance/financial-systems - finance/internal-audit-control - finance/investor-relations - finance/mergers-acquisitions - finance/real-estate-finance - finance/financial-risk - finance/shared-services - finance/sourcing-procurement - finance/tax - finance/treasury - human-resources - human-resources/compensation-benefits - human-resources/culture-diversity-inclusion - human-resources/employee-labor-relations - human-resources/health-safety - human-resources/human-resource-information-system - human-resources/human-resources - human-resources/hr-business-partner - human-resources/learning-development - human-resources/organizational-development - human-resources/recruiting-talent-acquisition - human-resources/talent-management - human-resources/workforce-management - human-resources/people-operations - information-technology - information-technology/application-development - information-technology/business-service-management-itsm - information-technology/collaboration-web-app - information-technology/data-center - information-technology/data-warehouse - information-technology/database-administration - information-technology/ecommerce-development - information-technology/enterprise-architecture - information-technology/help-desk-desktop-services - information-technology/hr-financial-erp-systems - information-technology/information-security - information-technology/information-technology - information-technology/infrastructure - information-technology/it-asset-management - information-technology/it-audit-it-compliance - information-technology/it-operations - information-technology/it-procurement - information-technology/it-strategy - information-technology/it-training - information-technology/networking - information-technology/project-program-management - information-technology/quality-assurance - information-technology/retail-store-systems - information-technology/servers - information-technology/storage-disaster-recovery - information-technology/telecommunications - information-technology/virtualization - legal - legal/acquisitions - legal/compliance - legal/contracts - legal/corporate-secretary - legal/ediscovery - legal/ethics - legal/governance - legal/governmental-affairs-regulatory-law - legal/intellectual-property-patent - legal/labor-employment - legal/lawyer-attorney - legal/legal - legal/legal-counsel - legal/legal-operations - legal/litigation - legal/privacy - marketing - marketing/advertising - marketing/brand-management - marketing/content-marketing - marketing/customer-experience - marketing/customer-marketing - marketing/demand-generation - marketing/digital-marketing - marketing/ecommerce-marketing - marketing/event-marketing - marketing/field-marketing - marketing/lead-generation - marketing/marketing - marketing/marketing-analytics-insights - marketing/marketing-communications - marketing/marketing-operations - marketing/product-marketing - marketing/public-relations - marketing/search-engine-optimization-pay-per-click - marketing/social-media-marketing - marketing/strategic-communications - marketing/technical-marketing - medical-health - medical-health/anesthesiology - medical-health/chiropractics - medical-health/clinical-systems - medical-health/dentistry - medical-health/dermatology - medical-health/doctors-physicians - medical-health/epidemiology - medical-health/first-responder - medical-health/infectious-disease - medical-health/medical-administration - medical-health/medical-education-training - medical-health/medical-research - medical-health/medicine - medical-health/neurology - medical-health/nursing - medical-health/nutrition-dietetics - medical-health/obstetrics-gynecology - medical-health/oncology - medical-health/opthalmology - medical-health/optometry - medical-health/orthopedics - medical-health/pathology - medical-health/pediatrics - medical-health/pharmacy - medical-health/physical-therapy - medical-health/psychiatry - medical-health/psychology - medical-health/public-health - medical-health/radiology - medical-health/social-work - operations - operations/call-center - operations/construction - operations/corporate-strategy - operations/customer-service-support - operations/enterprise-resource-planning - operations/facilities-management - operations/leasing - operations/logistics - operations/office-operations - operations/operations - operations/physical-security - operations/project-development - operations/quality-management - operations/real-estate - operations/safety - operations/store-operations - operations/supply-chain - sales - sales/account-management - sales/business-development - sales/channel-sales - sales/customer-retention-development - sales/customer-success - sales/field-outside-sales - sales/inside-sales - sales/partnerships - sales/revenue-operations - sales/sales - sales/sales-enablement - sales/sales-engineering - sales/sales-operations - sales/sales-training - consulting - consulting/consultant - null description: The department associated with the experience nullable: true PersonExperienceCompanyResponse: required: - id type: object properties: legalName: type: string description: The legal name of the company nullable: true website: type: string description: The company website URL nullable: true description: type: string description: The company description nullable: true type: $ref: '#/components/schemas/NullableOfCompanyType' foundedYear: type: integer description: The year the company was founded format: int32 nullable: true employees: $ref: '#/components/schemas/NullableOfCompanyEmployees' revenue: $ref: '#/components/schemas/NullableOfCompanyRevenue' industries: type: array items: type: string description: The industries associated with the company nullable: true categories: type: array items: $ref: '#/components/schemas/CompanyCategory' description: >- The categories associated with the company, from most to least specific nullable: true location: $ref: '#/components/schemas/CompanyLocationResponse' socials: $ref: '#/components/schemas/CompanySocialsResponse' updatedAt: type: string description: When the company data was last updated format: date-time nullable: true id: type: string description: The CompanyEnrich ID of the company format: uuid name: type: string description: The company name nullable: true domain: type: string description: The primary company domain nullable: true logoUrl: type: string description: The company logo URL nullable: true industry: type: string description: The company's primary industry nullable: true description: >- The matched company associated with the experience. Includes the standard company profile when `company` is requested in `expand` and the company is available. nullable: true PersonCompanyResponse: required: - id type: object properties: id: type: string description: The CompanyEnrich ID of the company format: uuid name: type: string description: The company name nullable: true domain: type: string description: The primary company domain nullable: true logoUrl: type: string description: The company logo URL nullable: true industry: type: string description: The company's primary industry nullable: true description: The matched educational institution nullable: true CompanySearchFilter3: type: object properties: query: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- Queries matching company names, keywords, or domain prefixes. A string or array matches any query. Inclusions use OR; exclusions remove matches. Each entry supports the existing text query syntax, up to 250 characters. A blank string is treated as no query; blank entries in arrays or matching rules are invalid. Provide a single value, multiple values, or advanced matching rules. nullable: true id: oneOf: - title: Single value type: string description: Include results that match this value. format: uuid - title: Multiple values minItems: 1 type: array items: type: string format: uuid description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string format: uuid description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string format: uuid description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The company ids to match. A single value or array matches any provided id. Provide a single value, multiple values, or advanced matching rules. nullable: true domain: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The company domains to match. A single value or array matches any provided domain. Provide a single value, multiple values, or advanced matching rules. nullable: true keywords: oneOf: - title: Single value type: string description: Only match when this value matches the target. - title: Multiple values minItems: 1 type: array items: type: string description: Only match when every provided value matches the target. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values all: minItems: 1 type: array items: type: string description: >- Only match when every provided value is present in the target collection additionalProperties: false description: >- Configure values that may match, must all match, or must be excluded. description: >- The keywords to match. A single value or array requires every provided keyword. Provide a single value, multiple values, or advanced matching rules. nullable: true technologies: oneOf: - title: Single value type: string description: Only match when this value matches the target. - title: Multiple values minItems: 1 type: array items: type: string description: Only match when every provided value matches the target. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values all: minItems: 1 type: array items: type: string description: >- Only match when every provided value is present in the target collection additionalProperties: false description: >- Configure values that may match, must all match, or must be excluded. description: >- The technologies to match. A single value or array requires every provided technology. Provide a single value, multiple values, or advanced matching rules. nullable: true region: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The regions to match. A single value or array matches any provided region. Provide a single value, multiple values, or advanced matching rules. nullable: true country: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The countries to match. A single value or array matches any provided country. Provide a single value, multiple values, or advanced matching rules. nullable: true state: oneOf: - title: Single value type: integer description: Include results that match this value. format: int32 - title: Multiple values minItems: 1 type: array items: type: integer format: int32 description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: integer format: int32 description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: integer format: int32 description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The state ids to match. A single value or array matches any provided id. Provide a single value, multiple values, or advanced matching rules. nullable: true city: oneOf: - title: Single value type: integer description: Include results that match this value. format: int32 - title: Multiple values minItems: 1 type: array items: type: integer format: int32 description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: integer format: int32 description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: integer format: int32 description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The city ids to match. A single value or array matches any provided id. Provide a single value, multiple values, or advanced matching rules. nullable: true type: oneOf: - title: Single value enum: - private - public - self-employed - self-owned - partnership - nonprofit - educational - government type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - private - public - self-employed - self-owned - partnership - nonprofit - educational - government type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - private - public - self-employed - self-owned - partnership - nonprofit - educational - government type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - private - public - self-employed - self-owned - partnership - nonprofit - educational - government type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The company types to match. A single value or array matches any provided type. Provide a single value, multiple values, or advanced matching rules. nullable: true employees: oneOf: - title: Single value enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The employee ranges to match. A single value or array matches any provided range. Provide a single value, multiple values, or advanced matching rules. nullable: true reportedEmployees: oneOf: - title: Single value enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The externally reported employee ranges to match. A single value or array matches any provided range. Provide a single value, multiple values, or advanced matching rules. nullable: true revenue: oneOf: - title: Single value enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The revenue ranges to match. A single value or array matches any provided range. Provide a single value, multiple values, or advanced matching rules. nullable: true workforceGrowth: $ref: '#/components/schemas/CompanyWorkforceGrowthV2Filter' workforceSize: type: array items: $ref: '#/components/schemas/CompanyWorkforceSizeV2Filter' description: The workforce headcount ranges of companies, by department nullable: true naicsCodes: oneOf: - title: Single value type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: type: string description: >- Exclude results when the target value is one of the provided values all: minItems: 1 type: array items: type: string description: >- Only match when every provided value is present in the target collection additionalProperties: false description: >- Configure values that may match, must all match, or must be excluded. description: >- The NAICS code strings to match, each containing 2 to 6 ASCII digits without a leading zero. Surrounding whitespace is ignored. A single value or array matches any provided code. Provide a single value, multiple values, or advanced matching rules. nullable: true categories: oneOf: - title: Single value enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business type: string description: Only match when this value matches the target. - title: Multiple values minItems: 1 type: array items: enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business type: string description: Only match when every provided value matches the target. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business type: string description: >- Exclude results when the target value is one of the provided values all: minItems: 1 type: array items: enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business type: string description: >- Only match when every provided value is present in the target collection additionalProperties: false description: >- Configure values that may match, must all match, or must be excluded. description: >- The categories to match. A single value or array requires every provided category. Provide a single value, multiple values, or advanced matching rules. nullable: true foundedYear: $ref: '#/components/schemas/YearRangeFilter' fundingRounds: oneOf: - title: Single value enum: - seed - debt_financing - angel - venture - series_a - series_b - series_c - series_d - series_e - series_f - series_g - series_h - other type: string description: Include results that match this value. - title: Multiple values minItems: 1 type: array items: enum: - seed - debt_financing - angel - venture - series_a - series_b - series_c - series_d - series_e - series_f - series_g - series_h - other type: string description: Include results that match at least one of these values. - title: Advanced matching rules minProperties: 1 type: object properties: in: minItems: 1 type: array items: enum: - seed - debt_financing - angel - venture - series_a - series_b - series_c - series_d - series_e - series_f - series_g - series_h - other type: string description: >- Only match when the target value is one of the provided values notIn: minItems: 1 type: array items: enum: - seed - debt_financing - angel - venture - series_a - series_b - series_c - series_d - series_e - series_f - series_g - series_h - other type: string description: >- Exclude results when the target value is one of the provided values additionalProperties: false description: Configure values that may match or must be excluded. description: >- The funding rounds to match. A single value or array matches any provided round. Provide a single value, multiple values, or advanced matching rules. nullable: true fundingAmount: $ref: '#/components/schemas/AmountRangeFilter' fundingYear: $ref: '#/components/schemas/YearRangeFilter2' require: oneOf: - title: Single value enum: - linkedin - twitter - facebook - instagram - angellist - crunchbase - youtube - country - city - state - revenue - foundedYear - anyFunding type: string description: Only match when this value matches the target. - title: Multiple values minItems: 1 type: array items: enum: - linkedin - twitter - facebook - instagram - angellist - crunchbase - youtube - country - city - state - revenue - foundedYear - anyFunding type: string description: Only match when every provided value matches the target. - title: Advanced matching rules minProperties: 1 type: object properties: all: minItems: 1 type: array items: enum: - linkedin - twitter - facebook - instagram - angellist - crunchbase - youtube - country - city - state - revenue - foundedYear - anyFunding type: string description: Only match when every provided value matches the target additionalProperties: false description: Configure values that must all match. description: >- The features companies must have. A single value or array requires every provided feature. Provide a single value, multiple values, or advanced matching rules. nullable: true description: >- Company filters inferred from the description and applied together with the request company filters, in the company search filter format. Omitted when none were inferred. nullable: true CompanySemanticBoostResponse2: type: object properties: names: type: array items: type: string description: >- Company names detected in the query. A company whose name contains one of them, or whose domain matches it, ranks above all other results. nullable: true categories: type: array items: $ref: '#/components/schemas/CompanyCategory' description: A company in any of these categories ranks higher nullable: true revenue: type: array items: $ref: '#/components/schemas/CompanyRevenue' description: A company in one of these revenue ranges ranks higher nullable: true description: >- Company attributes inferred from the description that rank matching companies higher when selecting the best-matching companies. Omitted when none were inferred or the description is not searched semantically. nullable: true NullableOfCompanyWorkforceGrowthPeriod: enum: - m6 - y1 - y2 - null description: The period to measure workforce growth over. nullable: true NullableOfCompanyWorkforceGrowthDepartment: enum: - overall - c_suite - product_management - engineering_technical - design - education - finance - human_resources - information_technology - legal - marketing - medical_health - operations - sales - consulting - null description: The department to measure workforce growth for. nullable: true NullableOfCompanyWorkforceGrowthDepartment2: enum: - overall - c_suite - product_management - engineering_technical - design - education - finance - human_resources - information_technology - legal - marketing - medical_health - operations - sales - consulting - null description: >- The department to filter headcount for. Defaults to overall if not specified. nullable: true NullableOfCompanyType: enum: - private - public - self-employed - self-owned - partnership - nonprofit - educational - government - null description: The company type nullable: true NullableOfCompanyEmployees: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K - null description: The estimated employee count range nullable: true NullableOfCompanyRevenue: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b - null description: The estimated annual revenue range in USD nullable: true CompanyCategory: enum: - b2b - b2c - b2g - e-commerce - media - service-provider - mobile - saas - local-business CompanyLocationResponse: type: object properties: country: $ref: '#/components/schemas/CompanyCountryResponse' state: $ref: '#/components/schemas/CompanyStateResponse' city: $ref: '#/components/schemas/CompanyCityResponse' address: type: string description: The company street address nullable: true postalCode: type: string description: The company postal code nullable: true phone: type: string description: The company phone number nullable: true description: The company location and contact details nullable: true CompanySocialsResponse: type: object properties: linkedinUrl: type: string description: The company LinkedIn URL nullable: true linkedinId: type: string description: The company LinkedIn ID nullable: true twitterUrl: type: string description: The company Twitter/X URL nullable: true facebookUrl: type: string description: The company Facebook URL nullable: true instagramUrl: type: string description: The company Instagram URL nullable: true angellistUrl: type: string description: The company AngelList URL nullable: true crunchbaseUrl: type: string description: The company Crunchbase URL nullable: true youtubeUrl: type: string description: The company YouTube URL nullable: true githubUrl: type: string description: The company GitHub URL nullable: true g2Url: type: string description: The company G2 URL nullable: true description: The company social profiles nullable: true CompanyRevenue: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b CompanyCountryResponse: required: - code - name type: object properties: code: type: string description: The ISO 3166-1 alpha-2 country code name: type: string description: The country name description: The country where the company is located nullable: true CompanyStateResponse: required: - id - name type: object properties: id: type: integer description: The CompanyEnrich state ID format: int32 name: type: string description: The state or province name code: type: string description: The ISO 3166-2 subdivision code nullable: true description: The state or province where the company is located nullable: true CompanyCityResponse: required: - id - name type: object properties: id: type: integer description: The CompanyEnrich city ID format: int32 name: type: string description: The city name description: The city where the company is located nullable: true securitySchemes: Bearer: type: apiKey description: >- API Token used for authentication. Example: "Authorization: Bearer {token}" name: Authorization in: header x-bearer-format: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.