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

# Company Enrichments

> Reference guide for company-level data enhancements available in Precept.

## Enrichment Types Overview

| Type                    | Description                              | Requires Departments/Titles | Credits                 |
| :---------------------- | :--------------------------------------- | :-------------------------- | :---------------------- |
| `decision_makers`       | Find key people at a company             | ✅                           | 0.5 per person per role |
| `employee_count`        | Current headcount by department or title | ✅                           | 2 per role              |
| `employee_count_change` | Historical headcount trends              | ✅                           | 4 per role              |
| `department_ratio`      | Proportion of staff across departments   | ✅                           | 4 per role              |
| `job_posting_insights`  | AI analysis of active job postings       | ✅                           | 5 per role              |
| `technology_stack`      | Technologies the company uses            | ❌                           | 2                       |
| `revenue`               | Estimated annual revenue                 | ❌                           | 5                       |
| `recent_funding`        | Most recent funding round                | ❌                           | 5                       |

<Info>
  Credits listed are **per company**. See [Understanding
  Credits](/essentials/credits) for full pricing details.
</Info>

***

## Role-Based Enrichments

The following enrichments require you to specify `departments` and/or `jobTitles` in the enrichments object. The enrichment is run once per department or job title you provide.

### Decision Makers

Find key people at a company by department or job title. Returns names, current titles, LinkedIn profiles, and department.

Optionally set `includeContactDetails: true` to also retrieve verified emails and phone numbers for each person found. Use `decisionMakersLimit` to control the maximum number of people returned. By default, this limit applies per queried role (department/job title). You can set `limitType` to `"overall"` to apply this limit as an absolute total across all roles. When using the overall limit, roles are searched sequentially in the order specified (departments first, then job titles), and the search stops once the total limit is reached. You can also use `country` to filter the decision makers by a list of countries (e.g., \["United Kingdom", "United States"]).

<Info>
  When `includeContactDetails` is enabled, the per-lead base cost is automatically
  discounted from **0.5 to 0.1 credits**. Additional credits for emails (+1) and
  phone numbers (+10) still apply per successfully found contact. See
  [Understanding Credits](/essentials/credits#decision-maker-contact-details) for
  the full breakdown.
</Info>

<CodeGroup>
  ```json Request theme={null}
  {
    "enrichments": {
      "type": "decision_makers",
      "departments": ["Sales", "Engineering and Technical"],
      "decisionMakersLimit": 3,
      "limitType": "overall",
      "country": ["United States", "Canada"],
      "includeContactDetails": true
    }
  }
  ```

  ```json Response theme={null}
  {
    "decision_makers": [
      {
        "name": "Jane Smith",
        "job_title": "Sales Manager",
        "company_name": "Acme Corp",
        "linkedin": "https://www.linkedin.com/in/janesmith",
        "department": "sales",
        "enrich_email": "[EMAIL_ADDRESS]",
        "enrich_phone": "+1234567890"
      }
    ]
  }
  ```
</CodeGroup>

### Employee Count

Get the current number of employees matching the specified departments or job titles.

<CodeGroup>
  ```json Request theme={null}
  {
    "enrichments": {
      "type": "employee_count",
      "departments": ["Engineering and Technical", "Sales"]
    }
  }
  ```

  ```json Response theme={null}
  {
    "employee_count": [
      {
        "department": "engineering",
        "text": "25"
      },
      {
        "department": "sales",
        "text": "10"
      }
    ]
  }
  ```
</CodeGroup>

### Employee Count Change

Track how headcount in specific departments or job titles has changed over time. Useful for identifying growing or shrinking teams.

<CodeGroup>
  ```json Request theme={null}
  {
    "enrichments": {
      "type": "employee_count_change",
      "departments": ["Engineering and Technical"]
    }
  }
  ```

  ```json Response theme={null}
  {
    "employee_count_change": [
      {
        "department": "engineering",
        "text": "15"
      }
    ]
  }
  ```
</CodeGroup>

### Department Ratio

Understand the proportional distribution of employees across the specified departments. Helpful for gauging how a company allocates resources.

<CodeGroup>
  ```json Request theme={null}
  {
    "enrichments": {
      "type": "department_ratio",
      "departments": ["Engineering and Technical", "Sales", "Marketing"]
    }
  }
  ```

  ```json Response theme={null}
  {
    "department_ratio": [
      {
        "department": "engineering",
        "text": "45"
      },
      {
        "department": "sales",
        "text": "30"
      },
      {
        "department": "marketing",
        "text": "15"
      }
    ]
  }
  ```
</CodeGroup>

### Job Posting Insights

Get an AI-powered analysis of a company's active job postings in the specified departments or job titles. The analysis includes the number of open roles, a summary of hiring activity, company-specific challenges being hired for, strategic goals, and key technologies mentioned.

<CodeGroup>
  ```json Request theme={null}
  {
    "enrichments": {
      "type": "job_posting_insights",
      "departments": ["Engineering and Technical"]
    }
  }
  ```

  ```json Response theme={null}
  {
    "job_posting_insights": [
      {
        "department": "engineering",
        "text": "**Job postings found: 12**.\n\nThe company is actively hiring to scale its core infrastructure and develop new AI-driven features.\n\n**Unique company-specific problems:**\n- Optimizing high-throughput data pipelines for real-time processing.\n- Implementing advanced LLM orchestration.\n\n**Current company goals and strategic initiatives:**\n- Scaling the platform to handle 10x more concurrent users.\n- Launching a localized product suite for the European market.\n\n**Key technologies and tools:**\n- TypeScript and Node.js for backend services.\n- Google Cloud Platform and Firebase for infrastructure."
      }
    ]
  }
  ```
</CodeGroup>

***

## Standalone Enrichments

These enrichments do not require `departments` or `jobTitles` — they apply at the company level.

### Technology Stack

Discover the technologies, frameworks, and tools a company uses. Returns an AI-generated summary based on public data such as job postings and company profiles.

<CodeGroup>
  ```json Request theme={null}
  {
    "enrichments": {
      "type": "technology_stack"
    }
  }
  ```

  ```json Response theme={null}
  {
    "technology_stack": "The company uses a modern tech stack including React, TypeScript, Node.js, and Firebase."
  }
  ```
</CodeGroup>

### Revenue

Get an estimated annual revenue figure for the company.

<CodeGroup>
  ```json Request theme={null}
  {
    "enrichments": {
      "type": "revenue"
    }
  }
  ```

  ```json Response theme={null}
  {
    "revenue": "$10,000,000 estimated annual revenue as of 2024"
  }
  ```
</CodeGroup>

### Recent Funding

Retrieve the company's most recent funding round, including the amount raised and the date.

<CodeGroup>
  ```json Request theme={null}
  {
    "enrichments": {
      "type": "recent_funding"
    }
  }
  ```

  ```json Response theme={null}
  {
    "company_recent_funding": "$25,000,000 raised on 2/1/2022"
  }
  ```
</CodeGroup>

***

## Available Departments

When using the `departments` parameter, you can use any of the following values (case-insensitive):

<Accordion title="Full list of departments">
  | Department                  |
  | :-------------------------- |
  | Actuary                     |
  | Administrative              |
  | C-Suite                     |
  | Claims                      |
  | Consulting                  |
  | Customer Service            |
  | Data & Analytics            |
  | Design                      |
  | Education                   |
  | Engineering and Technical   |
  | Finance & Accounting        |
  | Founder                     |
  | Governance & Quality        |
  | Health & Safety             |
  | Human Resources             |
  | Information Technology      |
  | Innovation                  |
  | Legal                       |
  | Logistics                   |
  | Marketing                   |
  | Medical                     |
  | Operations                  |
  | Pricing                     |
  | Procurement & Sourcing      |
  | Product                     |
  | Project Management          |
  | Quality Control & Assurance |
  | Real Estate                 |
  | Research                    |
  | Risk & Compliance           |
  | Sales                       |
  | Security                    |
  | Sustainability              |
  | Trades                      |
  | Underwriting                |
</Accordion>

## Custom Queries

In addition to structured enrichments, you can ask freeform questions about any company using the `queries` parameter. Each query costs **0.2 credits** per company.

```json theme={null}
{
  "queries": [
    "What is their go-to-market strategy?",
    "What compliance certifications do they hold?"
  ]
}
```

The responses are returned in the webhook payload under `query_responses`:

```json theme={null}
{
  "query_responses": [
    {
      "query": "What is their go-to-market strategy?",
      "text": "The company uses a product-led growth strategy..."
    }
  ]
}
```