> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lance.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Companies

> Search for companies using various filters and automatically enrich results with company data

Search for companies across the Lance database using comprehensive filters including industry, location, employee size, funding, and more. Results are automatically saved to the database and enriched with company summaries in the background.

## Authentication

This endpoint requires authentication. The user must be logged in and belong to an organization.

<Note>
  Company summary generation runs in the background and consumes credits. Only
  companies with a description and LinkedIn URL but no existing summary will be
  enriched.
</Note>

## Request

### Body Parameters

<ParamField body="url" type="string[]" optional>
  Array of company URLs (LinkedIn or website) to search for specific companies.
</ParamField>

<ParamField body="page" type="integer" default={0}>
  Page number for pagination (0-indexed).
</ParamField>

<ParamField body="size" type="integer" default={10}>
  Number of results per page. Must be between 0 and 100.
</ParamField>

<ParamField body="account" type="object" optional>
  Account-level filters for company search.

  <Expandable title="account properties">
    <ParamField body="account.nameOrDomain" type="object" optional>
      Filter by company name or domain with include/exclude patterns.

      <Expandable title="nameOrDomain properties">
        <ParamField body="all" type="object" optional>
          All conditions must match.

          <Expandable title="all properties">
            <ParamField body="include" type="object" optional>
              <ParamField body="mode" type="string" optional>
                Search match mode: `SMART`, `WORD`, or `STRICT`
              </ParamField>

              <ParamField body="content" type="string[]" optional>
                Array of terms to include
              </ParamField>
            </ParamField>

            <ParamField body="exclude" type="object" optional>
              <ParamField body="mode" type="string" optional>
                Search match mode: `SMART`, `WORD`, or `STRICT`
              </ParamField>

              <ParamField body="content" type="string[]" optional>
                Array of terms to exclude
              </ParamField>
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="any" type="object" optional>
          Any condition can match (same structure as `all`).
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.domain" type="object" optional>
      Filter by company domain with include/exclude arrays.

      <Expandable title="domain properties">
        <ParamField body="all" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Domains to include (all must match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Domains to exclude
          </ParamField>
        </ParamField>

        <ParamField body="any" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Domains to include (any can match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Domains to exclude
          </ParamField>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.socialMediaLink" type="object" optional>
      Filter by social media profile URLs with include/exclude arrays.

      <Expandable title="socialMediaLink properties">
        <ParamField body="all" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Social media URLs to include (all must match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Social media URLs to exclude
          </ParamField>
        </ParamField>

        <ParamField body="any" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Social media URLs to include (any can match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Social media URLs to exclude
          </ParamField>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.phoneNumber" type="object" optional>
      Filter by company phone numbers with include/exclude arrays.

      <Expandable title="phoneNumber properties">
        <ParamField body="all" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Phone numbers to include (all must match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Phone numbers to exclude
          </ParamField>
        </ParamField>

        <ParamField body="any" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Phone numbers to include (any can match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Phone numbers to exclude
          </ParamField>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.industry" type="object" optional>
      Filter by industry. Supports 900+ industries including:
      `software development`, `it services and it consulting`, `financial services`, `hospitals and health care`, `manufacturing`, `retail`, `construction`, `real estate`, `education`, `marketing`, `biotechnology`, `telecommunications`, `saas`, `fintech`, `artificial intelligence (ai)`, `generative ai`, `blockchain`, `cryptocurrency`, and many more.

      <Expandable title="industry properties">
        <ParamField body="all" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Industries to include (all must match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Industries to exclude
          </ParamField>
        </ParamField>

        <ParamField body="any" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Industries to include (any can match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Industries to exclude
          </ParamField>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.location" type="object" optional>
      Filter by company location (country, state, city).

      <Expandable title="location properties">
        <ParamField body="all" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Locations to include (all must match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Locations to exclude
          </ParamField>
        </ParamField>

        <ParamField body="any" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Locations to include (any can match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Locations to exclude
          </ParamField>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.productAndServices" type="object" optional>
      Filter by company products and services with search modes.

      <Expandable title="productAndServices properties">
        <ParamField body="all" type="object" optional>
          All conditions must match.

          <Expandable title="all properties">
            <ParamField body="include" type="object" optional>
              <ParamField body="mode" type="string" optional>
                Search match mode: `SMART`, `WORD`, or `STRICT`
              </ParamField>

              <ParamField body="content" type="string[]" optional>
                Array of products/services to include
              </ParamField>
            </ParamField>

            <ParamField body="exclude" type="object" optional>
              <ParamField body="mode" type="string" optional>
                Search match mode: `SMART`, `WORD`, or `STRICT`
              </ParamField>

              <ParamField body="content" type="string[]" optional>
                Array of products/services to exclude
              </ParamField>
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="any" type="object" optional>
          Any condition can match (same structure as `all`).
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.socialMedia" type="object" optional>
      Filter by social media presence. Values: `FACEBOOK`, `INSTAGRAM`, `TWITTER`, `LINKEDIN`.

      <Expandable title="socialMedia properties">
        <ParamField body="all" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Social media platforms to include (all must match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Social media platforms to exclude
          </ParamField>
        </ParamField>

        <ParamField body="any" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Social media platforms to include (any can match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Social media platforms to exclude
          </ParamField>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.type" type="object" optional>
      Filter by company type. Values: `PRIVATELY_HELD`, `PUBLIC_COMPANY`, `GOVERNMENT_AGENCY`, `PARTNERSHIP`, `SOLE_PROPRIETORSHIP`, `NON_PROFIT`, `EDUCATIONAL`, `SELF_OWNED`, `SELF_EMPLOYED`.

      <Expandable title="type properties">
        <ParamField body="all" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Company types to include (all must match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Company types to exclude
          </ParamField>
        </ParamField>

        <ParamField body="any" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Company types to include (any can match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Company types to exclude
          </ParamField>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.foundedYear" type="object" optional>
      Filter by founded year range.

      <Expandable title="foundedYear properties">
        <ParamField body="start" type="integer" optional>
          Minimum founded year
        </ParamField>

        <ParamField body="end" type="integer" optional>
          Maximum founded year
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.employeeSize" type="object" optional>
      Filter by employee count range.

      <Expandable title="employeeSize properties">
        <ParamField body="type" type="string" required>
          Must be `RANGE`
        </ParamField>

        <ParamField body="range" type="object[]" required>
          Array of range objects with `start` and `end` values.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.revenue" type="object" optional>
      Filter by annual revenue range (same structure as employeeSize).

      <Expandable title="revenue properties">
        <ParamField body="type" type="string" required>
          Must be `RANGE`
        </ParamField>

        <ParamField body="range" type="object[]" required>
          Array of range objects with `start` and `end` values.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.language" type="object" optional>
      Filter by company operating language. Supports 49 languages: `english`, `spanish`, `french`, `portuguese`, `german`, `dutch`, `italian`, `chinese`, `turkish`, `polish`, `russian`, `swedish`, `arabic`, `indonesian`, `danish`, `czech`, `norwegian`, `japanese`, `korean`, `romanian`, `ukrainian`, `thai`, `hindi`, `malay`, `tagalog`, `vietnamese`, `finnish`, `persian`, `greek`, `hungarian`, `bengali`, `marathi`, `telugu`, `panjabi`, `serbian`, `slovak`, `croatian`, `lithuanian`, `latvian`, `albanian`, `icelandic`, `armenian`, `bosnian`, `tamil`, `javanese`, `malayalam`, `kannada`, `burmese`.

      <Expandable title="language properties">
        <ParamField body="all" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Language enum values to include (all must match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Language enum values to exclude
          </ParamField>
        </ParamField>

        <ParamField body="any" type="object" optional>
          <ParamField body="include" type="string[]" optional>
            Language enum values to include (any can match)
          </ParamField>

          <ParamField body="exclude" type="string[]" optional>
            Language enum values to exclude
          </ParamField>
        </ParamField>

        <ParamField body="range" type="object" optional>
          Range filter for number of languages
          <ParamField body="start" type="number" optional>Minimum count</ParamField>
          <ParamField body="end" type="number" optional>Maximum count</ParamField>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.geoLocation" type="object" optional>
      Filter by geographic coordinates.

      <Expandable title="geoLocation properties">
        <ParamField body="position" type="object" optional>
          <ParamField body="lat" type="number" optional>Latitude (-90 to 90)</ParamField>
          <ParamField body="lng" type="number" optional>Longitude (-180 to 180)</ParamField>
        </ParamField>

        <ParamField body="radius" type="number" optional>
          Search radius
        </ParamField>

        <ParamField body="unit" type="string" optional>
          Unit of measure: `km` or `mi`
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.keyword" type="object" optional>
      Search by keywords across company data sources.

      <Expandable title="keyword properties">
        <ParamField body="all" type="object" optional>
          <ParamField body="include" type="object" optional>
            <ParamField body="sources" type="object[]" optional>
              Array of source configurations with `mode` (`SMART`, `WORD`, `STRICT`) and `source`. Sources: `NAME`, `KEYWORD`, `SEO`, `DESCRIPTION`, `INDUSTRY`
            </ParamField>

            <ParamField body="content" type="string[]" optional>
              Keywords to search for
            </ParamField>
          </ParamField>

          <ParamField body="exclude" type="object" optional>
            Same structure as include
          </ParamField>
        </ParamField>

        <ParamField body="any" type="object" optional>
          Same structure as `all`
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.funding" type="object" optional>
      Filter by funding information.

      <Expandable title="funding properties">
        <ParamField body="type" type="string[]" optional>
          Funding round types: `PRE_SEED`, `SEED`, `SERIES_A`, `SERIES_B`, `SERIES_C`, `SERIES_D`, `SERIES_E`, `SERIES_F`, `SERIES_G`, `SERIES_H`, `SERIES_I`, `SERIES_J`, `VENTURE_ROUND`, `ANGEL`, `PRIVATE_EQUITY`, `DEBT_FINANCING`, `CONVERTIBLE_NOTE`, `GRANT`, `CORPORATE_ROUND`, `EQUITY_CROWDFUNDING`, `PRODUCT_CROWDFUNDING`, `SECONDARY_MARKET`, `POST_IPO_EQUITY`, `POST_IPO_DEBT`, `POST_IPO_SECONDARY`, `NON_EQUITY_ASSISTANCE`, `INITIAL_COIN_OFFERING`, `UNDISCLOSED`, `SERIES_UNKNOWN`, `FUNDING_ROUND`
        </ParamField>

        <ParamField body="totalAmount" type="object" optional>
          Range filter for total funding amount (`start`, `end`)
        </ParamField>

        <ParamField body="lastAmount" type="object" optional>
          Range filter for last funding round amount (`start`, `end`)
        </ParamField>

        <ParamField body="duration" type="object" optional>
          Time range for funding (`start`, `end` as ISO timestamps)
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="account.metric" type="object" optional>
      Filter by company metrics (employee counts by department, growth rates).

      <Expandable title="metric properties">
        <ParamField body="employee" type="object[]" optional>
          Array of employee count filters by department. Each object has:

          * `function`: array of department enums (see below)
          * `start`: minimum employee count
          * `end`: maximum employee count

          Department values: `program_and_project_management`, `education`, `purchasing`, `accounting`, `sales`, `research`, `operations`, `customer_success_and_support`, `legal`, `product_management`, `media_and_communication`, `real_estate`, `quality_assurance`, `consulting`, `arts_and_design`, `healthcare_services`, `entrepreneurship`, `engineering`, `community_and_social_services`, `marketing`, `information_technology`, `business_development`, `administrative`, `military_and_protective_services`, `finance`, `human_resources`, `support`
        </ParamField>

        <ParamField body="growth" type="object[]" optional>
          Array of headcount growth filters by department. Each object has:

          * `function`: array of department enums (same as employee, also accepts custom strings)
          * `start`: minimum growth percentage
          * `end`: maximum growth percentage
          * `timeFrame`: `ONE`, `THREE`, `SIX`, `TWELVE`, or `TWENTY_FOUR` (months)
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

## Response

<ResponseField name="content" type="Company[]">
  Array of company objects matching the search criteria.

  <Expandable title="Company object properties">
    <ResponseField name="id" type="string">
      Unique identifier (UUID) for the company.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO timestamp when the company record was created.
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO timestamp when the company record was last updated.
    </ResponseField>

    <ResponseField name="name" type="string">
      Company name.
    </ResponseField>

    <ResponseField name="description" type="string | null">
      Full company description.
    </ResponseField>

    <ResponseField name="summary" type="string | null">
      AI-generated company summary (generated in background if not present).
    </ResponseField>

    <ResponseField name="headcount" type="string | null">
      Employee count range (e.g., "51-200").
    </ResponseField>

    <ResponseField name="industry" type="string | null">
      Primary industry classification.
    </ResponseField>

    <ResponseField name="phones" type="string[]">
      Array of company phone numbers.
    </ResponseField>

    <ResponseField name="linkedinUrl" type="string | null">
      LinkedIn company page URL.
    </ResponseField>

    <ResponseField name="websiteUrl" type="string | null">
      Company website URL.
    </ResponseField>

    <ResponseField name="domain" type="string | null">
      Company domain (extracted from website).
    </ResponseField>

    <ResponseField name="city" type="string | null">
      Headquarters city.
    </ResponseField>

    <ResponseField name="postalCode" type="string | null">
      Headquarters postal code.
    </ResponseField>

    <ResponseField name="country" type="string | null">
      Headquarters country.
    </ResponseField>

    <ResponseField name="logoUrl" type="string | null">
      URL to company logo image.
    </ResponseField>

    <ResponseField name="baseProviderId" type="string | null">
      Internal provider identifier.
    </ResponseField>

    <ResponseField name="bullhornId" type="integer | null">
      Bullhorn CRM identifier.
    </ResponseField>

    <ResponseField name="crmId" type="string | null">
      Generic CRM identifier.
    </ResponseField>

    <ResponseField name="legalName" type="string | null">
      Legal/registered company name.
    </ResponseField>

    <ResponseField name="foundedYear" type="integer | null">
      Year the company was founded.
    </ResponseField>

    <ResponseField name="revenue" type="string | null">
      Estimated annual revenue range.
    </ResponseField>

    <ResponseField name="location" type="object | null">
      Detailed location information.

      <Expandable title="location properties">
        <ResponseField name="headquarter" type="object | null">
          Headquarters location with `continent`, `country`, `state`, `city`, `street`, `postalCode`, `rawAddress`, and `coordinates` (`lat`, `lng`).
        </ResponseField>

        <ResponseField name="locations" type="object[]">
          Array of additional office locations (same structure as headquarter).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="totalElements" type="integer | null">
  Total number of companies matching the search criteria.
</ResponseField>

<ResponseField name="totalPages" type="integer | null">
  Total number of pages available.
</ResponseField>

<ResponseField name="number" type="integer | null">
  Current page number (0-indexed).
</ResponseField>

<ResponseField name="size" type="integer | null">
  Number of results per page.
</ResponseField>

<ResponseField name="first" type="boolean | null">
  Whether this is the first page.
</ResponseField>

<ResponseField name="last" type="boolean | null">
  Whether this is the last page.
</ResponseField>

<ResponseField name="numberOfElements" type="integer | null">
  Number of elements in the current page.
</ResponseField>

<ResponseField name="empty" type="boolean | null">
  Whether the result set is empty.
</ResponseField>

## Examples

<RequestExample>
  ```bash Basic Company Search theme={null}
  curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
      "page": 0,
      "size": 10,
      "account": {
        "industry": {
          "any": {
            "include": ["software development", "it services and it consulting"]
          }
        },
        "location": {
          "any": {
            "include": ["United States"]
          }
        }
      }
    }'
  ```

  ```bash Search by Employee Size theme={null}
  curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
      "page": 0,
      "size": 25,
      "account": {
        "employeeSize": {
          "type": "RANGE",
          "range": [
            { "start": 50, "end": 200 }
          ]
        },
        "industry": {
          "any": {
            "include": ["fintech", "financial services"]
          }
        }
      }
    }'
  ```

  ```bash Search with Funding Filters theme={null}
  curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
      "page": 0,
      "size": 20,
      "account": {
        "funding": {
          "type": ["SERIES_A", "SERIES_B", "SERIES_C"],
          "totalAmount": {
            "start": 1000000,
            "end": 50000000
          }
        },
        "foundedYear": {
          "start": 2015,
          "end": 2023
        }
      }
    }'
  ```

  ```bash Search by Keywords theme={null}
  curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
      "page": 0,
      "size": 15,
      "account": {
        "keyword": {
          "any": {
            "include": {
              "sources": [
                { "mode": "SMART", "source": "DESCRIPTION" },
                { "mode": "SMART", "source": "KEYWORD" }
              ],
              "content": ["artificial intelligence", "machine learning", "automation"]
            }
          }
        }
      }
    }'
  ```

  ```bash Search by Company URLs theme={null}
  curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
      "url": [
        "https://www.linkedin.com/company/anthropic",
        "https://www.openai.com"
      ],
      "page": 0,
      "size": 10
    }'
  ```

  ```bash Search by Products and Services theme={null}
  curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
      "page": 0,
      "size": 20,
      "account": {
        "productAndServices": {
          "any": {
            "include": {
              "mode": "SMART",
              "content": ["CRM", "sales automation", "lead generation"]
            }
          }
        }
      }
    }'
  ```

  ```bash Search by Company Growth Metrics theme={null}
  curl -X POST https://api.lance.app/api/v1/entities/prospects/company \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
      "page": 0,
      "size": 20,
      "account": {
        "metric": {
          "growth": [
            {
              "function": ["engineering", "sales"],
              "start": 10,
              "end": 100,
              "timeFrame": "TWELVE"
            }
          ]
        }
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "content": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "createdAt": "2024-01-15T10:30:00.000Z",
        "updatedAt": "2024-01-15T10:30:00.000Z",
        "name": "Acme Technologies Inc.",
        "description": "Acme Technologies is a leading provider of enterprise software solutions...",
        "summary": "Enterprise software company specializing in cloud-based workflow automation and data analytics for Fortune 500 companies.",
        "headcount": "201-500",
        "industry": "software development",
        "phones": ["+1-555-123-4567"],
        "linkedinUrl": "https://www.linkedin.com/company/acme-technologies",
        "websiteUrl": "https://www.acmetech.com",
        "domain": "acmetech.com",
        "city": "San Francisco",
        "postalCode": "94105",
        "country": "United States",
        "logoUrl": "https://media.licdn.com/company/acme-logo.png",
        "baseProviderId": "ark_123456",
        "bullhornId": null,
        "crmId": null,
        "legalName": "Acme Technologies, Inc.",
        "foundedYear": 2015,
        "revenue": "$10M - $50M",
        "location": {
          "headquarter": {
            "continent": "North America",
            "country": "United States",
            "state": "California",
            "city": "San Francisco",
            "street": "123 Market Street",
            "postalCode": "94105",
            "rawAddress": "123 Market Street, San Francisco, CA 94105",
            "coordinates": {
              "lat": 37.7749,
              "lng": -122.4194
            }
          },
          "locations": []
        }
      }
    ],
    "totalElements": 1542,
    "totalPages": 155,
    "number": 0,
    "size": 10,
    "first": true,
    "last": false,
    "numberOfElements": 10,
    "empty": false
  }
  ```

  ```json Empty Response theme={null}
  {
    "content": [],
    "totalElements": 0,
    "totalPages": 0,
    "number": 0,
    "size": 10,
    "first": true,
    "last": true,
    "numberOfElements": 0,
    "empty": true
  }
  ```
</ResponseExample>

## Error Responses

<ResponseField name="400 Bad Request">
  Returned when the request body fails validation.

  ```json theme={null}
  {
    "error": "Invalid request body",
    "issues": [
      {
        "code": "too_big",
        "maximum": 100,
        "type": "number",
        "inclusive": true,
        "exact": false,
        "message": "Number must be less than or equal to 100",
        "path": ["size"]
      }
    ]
  }
  ```
</ResponseField>

## Background Processing

This endpoint triggers two background processes:

1. **Global Company Repository Sync**: All returned companies are saved to the global company repository for cross-tenant data sharing.

2. **Company Summary Generation**: Companies that have a `description` and `linkedinUrl` but no `summary` will have AI-generated summaries created in the background. This process:
   * Consumes credits from the organization's account
   * Only runs in production with valid organization credentials
   * Updates the company records asynchronously

<Info>
  The response returns immediately with the search results. Background
  processing does not affect response time.
</Info>