> ## Documentation Index
> Fetch the complete documentation index at: https://fe-dev.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Company

> Search for companies based on various filters. Multiple filters within the same field are combined with AND logic.

The Company Search endpoint allows you to search for companies by size, industry, location, founding year, specialties, and more. It is designed to help you build clean company lists for prospecting, enrichment, or market analysis.

\*\*If you want to retrieve one specific company, \*\*you can search directly using its LinkedIn company URL or domain for an exact match.

<Card title="Predefined Filter Values" icon="tags" iconType="duotone" horizontal href="/api/v2/general/enums">
  For a full list of supported filters and accepted values (industries, company types, seniority levels, etc.)
</Card>


## OpenAPI

````yaml api/v2/reference/openapi.yml post /company/search
openapi: 3.1.0
info:
  title: FullEnrich API Documentation
  version: 2.0.0
  description: >
    FullEnrich API enables you to enrich B2B contacts with emails and phone
    numbers using data from 20+ providers.


    We are GDPR and CCPA compliant.
servers:
  - url: https://app.fullenrich.com/api/v2
security: []
paths:
  /company/search:
    post:
      summary: Search company
      description: >-
        Search for companies based on various filters. Multiple filters within
        the same field are combined with AND logic.
      operationId: postCompanySearch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchCompanyRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SearchCompanyResponse'
                  - $ref: '#/components/schemas/Metadata'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                AuthorizationHeaderNotSet:
                  value:
                    code: error.authorization.not_set
                    message: Authorization headers not set
                AuthorizationHeaderNotAnBearer:
                  value:
                    code: error.authorization.not_bearer
                    message: Authorization headers do not have prefix 'bearer'
                UnknownApiKey:
                  value:
                    code: error.api.key
                    message: Unknown api key
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                RateLimitExceeded:
                  value:
                    code: error.rate.limit
                    message: Too many requests. Try again in 1m
      security:
        - BearerAuth: []
components:
  schemas:
    SearchCompanyRequest:
      type: object
      properties:
        offset:
          type: integer
          description: Number of companies to skip (use this for pagination)
          example: 20
        limit:
          type: integer
          description: 'Number of companies to return (default: 10, max: 100)'
          example: 20
        names:
          type: array
          description: >-
            Filter by company names. Use exact_match for precise company name
            matching.
          items:
            type: object
            properties:
              value:
                type: string
                description: The string value to filter by
                example: Microsoft
              exclude:
                type: boolean
                description: >-
                  If true, excludes results matching this value. If false or
                  omitted (default), includes only matching results.
                example: false
              exact_match:
                type: boolean
                description: >-
                  When true, the exact term must appear within the value, but
                  can still be part of a longer string. When false (default),
                  matching is flexible and tolerates slight variations such as
                  missing or extra words. Matching is never case-sensitive.
                example: true
          example:
            - value: Microsoft
              exact_match: true
              exclude: false
        domains:
          type: array
          description: >-
            Filter by company domains (e.g., 'google.com', 'microsoft.com').
            Exact match recommended.
          items:
            type: object
            properties:
              value:
                type: string
                description: The string value to filter by
                example: microsoft.com
              exclude:
                type: boolean
                description: >-
                  If true, excludes results matching this value. If false or
                  omitted (default), includes only matching results.
                example: false
              exact_match:
                type: boolean
                description: >-
                  When true, the exact term must appear within the value, but
                  can still be part of a longer string. When false (default),
                  matching is flexible and tolerates slight variations such as
                  missing or extra words. Matching is never case-sensitive.
                example: true
          example:
            - value: microsoft.com
              exact_match: true
              exclude: false
        linkedin_urls:
          type: array
          description: Filter by LinkedIn URLs.
          items:
            type: object
            properties:
              value:
                type: string
                description: The string value to filter by
                example: https://www.linkedin.com/company/fullenrich
              exclude:
                type: boolean
                description: >-
                  If true, excludes results matching this value. If false or
                  omitted (default), includes only matching results.
                example: false
              exact_match:
                type: boolean
                description: >-
                  When true, the exact term must appear within the value, but
                  can still be part of a longer string. When false (default),
                  matching is flexible and tolerates slight variations such as
                  missing or extra words. Matching is never case-sensitive.
                example: true
          example:
            - value: https://www.linkedin.com/company/fullenrich
              exact_match: true
              exclude: false
        keywords:
          type: array
          description: Filter by description of company
          items:
            type: object
            properties:
              value:
                type: string
                description: The string value to filter by
                example: innovative and practical products
              exclude:
                type: boolean
                description: >-
                  If true, excludes results matching this value. If false or
                  omitted (default), includes only matching results.
                example: false
              exact_match:
                type: boolean
                description: >-
                  When true, the exact term must appear within the value, but
                  can still be part of a longer string. When false (default),
                  matching is flexible and tolerates slight variations such as
                  missing or extra words. Matching is never case-sensitive.
                example: false
          example:
            - value: innovative and practical products
              exact_match: false
              exclude: false
        specialties:
          type: array
          description: Filter by specialties of company
          items:
            type: object
            properties:
              value:
                type: string
                description: The string value to filter by
                example: AI safety
              exclude:
                type: boolean
                description: >-
                  If true, excludes results matching this value. If false or
                  omitted (default), includes only matching results.
                example: false
              exact_match:
                type: boolean
                description: >-
                  When true, the exact term must appear within the value, but
                  can still be part of a longer string. When false (default),
                  matching is flexible and tolerates slight variations such as
                  missing or extra words. Matching is never case-sensitive.
                example: false
          example:
            - value: AI safety
              exact_match: false
              exclude: false
        industries:
          type: array
          description: >-
            Filter by company industries (e.g., 'Software Development',
            'Computer Hardware Manufacturing', 'Housing and Community
            Development', 'Warehousing', 'Financial Services')
          items:
            type: object
            properties:
              value:
                type: string
                description: The string value to filter by
                example: Software Development
              exclude:
                type: boolean
                description: >-
                  If true, excludes results matching this value. If false or
                  omitted (default), includes only matching results.
                example: false
              exact_match:
                type: boolean
                description: >-
                  When true, the exact term must appear within the value, but
                  can still be part of a longer string. When false (default),
                  matching is flexible and tolerates slight variations such as
                  missing or extra words. Matching is never case-sensitive.
                example: false
          example:
            - value: Software Development
              exact_match: false
              exclude: false
            - value: Computer Hardware Manufacturing
              exact_match: false
              exclude: false
        types:
          type: array
          description: >-
            Filter by company types (e.g., 'Public Company', 'Privately Held',
            'Non-profit', 'Self-employed', 'Partnership')
          items:
            type: object
            properties:
              value:
                type: string
                description: The string value to filter by
                example: Public Company
              exclude:
                type: boolean
                description: >-
                  If true, excludes results matching this value. If false or
                  omitted (default), includes only matching results.
                example: false
              exact_match:
                type: boolean
                description: >-
                  When true, the exact term must appear within the value, but
                  can still be part of a longer string. When false (default),
                  matching is flexible and tolerates slight variations such as
                  missing or extra words. Matching is never case-sensitive.
                example: true
          example:
            - value: Public Company
              exact_match: true
              exclude: false
        headquarters_locations:
          type: array
          description: Filter by headquarters locations (city names, regions, or countries)
          items:
            type: object
            properties:
              value:
                type: string
                description: The string value to filter by
                example: San Francisco
              exclude:
                type: boolean
                description: >-
                  If true, excludes results matching this value. If false or
                  omitted (default), includes only matching results.
                example: false
              exact_match:
                type: boolean
                description: >-
                  When true, the exact term must appear within the value, but
                  can still be part of a longer string. When false (default),
                  matching is flexible and tolerates slight variations such as
                  missing or extra words. Matching is never case-sensitive.
                example: false
          example:
            - value: San Francisco
              exact_match: false
              exclude: false
        founded_years:
          type: array
          description: >-
            Filter by founding years. Useful for targeting startups (recent
            years) or established companies.
          items:
            type: object
            properties:
              min:
                type: integer
                description: Minimum founding year (inclusive)
                example: 2010
              max:
                type: integer
                description: Maximum founding year (inclusive)
                example: 2024
              exclude:
                type: boolean
                description: If true, excludes companies founded in this range
                example: false
          example:
            - min: 2015
              max: 2024
              exclude: false
        headcounts:
          type: array
          description: >-
            Filter by company headcounts (number of employees). Use ranges to
            target specific company sizes (e.g., startups: 1-50, mid-size:
            50-500, enterprise: 1000+).
          items:
            type: object
            properties:
              min:
                type: integer
                description: Minimum number of employees (inclusive)
                example: 100
              max:
                type: integer
                description: Maximum number of employees (inclusive)
                example: 1000
              exclude:
                type: boolean
                description: If true, excludes companies in this range
                example: false
          example:
            - min: 100
              max: 500
              exclude: false
        company_ids:
          type: array
          description: Filter by specific company IDs
          items:
            type: object
            properties:
              value:
                type: string
                description: The string value to filter by
                example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
              exclude:
                type: boolean
                description: >-
                  If true, excludes results matching this value. If false or
                  omitted (default), includes only matching results.
                example: false
              exact_match:
                type: boolean
                description: >-
                  When true, the exact term must appear within the value, but
                  can still be part of a longer string. When false (default),
                  matching is flexible and tolerates slight variations such as
                  missing or extra words. Matching is never case-sensitive.
                example: true
    SearchCompanyResponse:
      type: object
      properties:
        companies:
          type: array
          description: >-
            Array of companies matching the search criteria. Returns empty array
            if no results found.
          items:
            $ref: '#/components/schemas/Company'
    Metadata:
      type: object
      properties:
        metadata:
          type: object
          properties:
            total:
              type: integer
              description: Total number of results matching the search criteria
              example: 20523
            offset:
              type: integer
              description: Number of results skipped (for pagination)
              example: 0
    Error:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
    Company:
      type: object
      properties:
        id:
          type: string
          description: Unique company identifier
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        name:
          type: string
          description: Company name
          example: Anthropic
        domain:
          type: string
          description: Company domain
          example: anthropic.com
        description:
          type: string
          description: Company description
          example: >-
            AI safety and research company building reliable, interpretable, and
            steerable AI systems.
        year_founded:
          type: integer
          description: Year the company was founded
          example: 2021
        headcount:
          type: integer
          description: Exact number of employees
          example: 2610
        headcount_range:
          type: string
          description: >-
            Employee count range (e.g., '1-10', '11-50', '51-200', '201-500',
            '501-1000', '1001-5000', '5001-10000', '10000+')
          example: 1001-5000
        company_type:
          type: string
          description: >-
            Type of company (e.g., 'Public Company', 'Privately Held',
            'Non-profit', 'Self-employed', 'Partnership')
          example: Privately Held
        locations:
          type: object
          description: Company location information
          properties:
            headquarters:
              type: object
              description: Main headquarters address
              allOf:
                - $ref: '#/components/schemas/CompanyAddress'
            offices:
              type: array
              description: Additional office locations
              items:
                $ref: '#/components/schemas/CompanyAddress'
        social_profiles:
          type: object
          description: Company's social media profiles
          allOf:
            - $ref: '#/components/schemas/CompanySocialProfile'
        specialties:
          type: array
          description: Specialties associated with the company
          items:
            type: string
          example:
            - artificial intelligence
            - machine learning
            - AI safety
        industry:
          type: object
          description: Company industry information
          properties:
            main_industry:
              type: string
              description: >-
                Primary industry category (e.g., 'Software Development',
                'Computer Hardware Manufacturing', 'Financial Services',
                'Healthcare', 'Retail')
              example: Software Development
    CompanyAddress:
      type: object
      properties:
        line1:
          type: string
          description: Address line 1 (street address)
          example: 548 Market St
        line2:
          type: string
          description: Address line 2 (suite, building, etc.)
          example: PMB 42570
        city:
          type: string
          description: City name
          example: San Francisco
        region:
          type: string
          description: State or region
          example: California
        country:
          type: string
          description: Country name
          example: United States
        country_code:
          type: string
          description: ISO country code
          example: US
    CompanySocialProfile:
      type: object
      properties:
        linkedin:
          type: object
          description: LinkedIn profile information
          properties:
            url:
              type: string
              description: Full LinkedIn profile URL
              example: https://www.linkedin.com/company/anthropic
            handle:
              type: string
              description: LinkedIn profile handle/username
              example: anthropic
            follower_count:
              type: integer
              description: Number of LinkedIn followers
              example: 125000
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: string

````