# Enrich companies

Queue companies for LinkedIn data enrichment. GetSales will visit each company's
LinkedIn page and update their data — description, industry, employee count,
specialties, headquarters, logo, and more.

Works identically to lead enrichment: pass a filter or uuids, and the
system will validate credits and queue companies for processing.

Credit system: Shares the same monthly credit pool as contact enrichment.

Endpoint: PUT /leads/api/companies/advanced-enrichment
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `filter` (object)
    Mass action filter. Use all: true with a companyFilter to select companies by criteria, or all: false with specific ids.

  - `filter.all` (boolean)

  - `filter.ids` (array)

  - `filter.excludeIds` (array)

  - `filter.companyFilter` (object)
    Same filter object as in company search — linkedin_status, tags, etc.

  - `uuids` (array)
    Specific company UUIDs to enrich. Required if filter is not provided.

## Response 200 fields (application/json):

  - `count` (integer)
    Number of companies added to the enrichment queue

## Response 402 fields (application/json):

  - `error` (object)

  - `error.reason` (string)
    Error category
    Example: "validation_error"

  - `error.message` (string)
    Detailed error message
    Example: "The name field is required."

  - `error.data` (object)
    Additional context (field-level errors for validation)

  - `message` (string)
    Example: "Validation failed"

  - `code` (integer)
    Example: 422