> ## 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.

# Understanding Credits

> Learn how Precept's credit-based pricing works for company enrichment, contact search, and lead data. Detailed breakdown of costs per API call and enrichment type.

At Precept, we use a credit-based system to give you the flexibility to pay only for the data you need. This page explains how credits are consumed for our main API features.

## Lead Enrichment & Search

Credit costs for Leads are based on whether you are enriching existing leads or searching for new ones, and the level of data requested.

### Base Costs

| Feature Type        | Base Cost (Per Lead) | With Insights (Per Lead) |
| :------------------ | :------------------- | :----------------------- |
| **Lead Enrichment** | 1 credit             | (Always included)        |
| **Lead Search**     | 0.5 credits          | 1.5 credits              |

### Optional Contact Details

If you request contact details (emails or phone numbers) during a **Lead Search** or **Decision Maker** enrichment, two things happen:

1. The **base lead cost is discounted** from 0.5 to **0.1 credits** per lead.
2. Additional credits are charged **per lead** for successfully found contact details.

| Scenario                                 | Lead Cost | Contact Cost | Total Per Lead |
| :--------------------------------------- | :-------- | :----------- | :------------- |
| **Lead Search — no contact details**     | 0.5       | —            | **0.5**        |
| **Lead Search — emails only**            | 0.1       | +1           | **1.1**        |
| **Lead Search — phone numbers only**     | 0.1       | +10          | **10.1**       |
| **Lead Search — emails + phone numbers** | 0.1       | +11          | **11.1**       |

<Note>
  You are only charged for contact details that we successfully find and return.
  The discounted 0.1 base cost applies automatically whenever contact enrichment is requested.
</Note>

### Advanced Filtering

When using Lead Search, you can optionally filter leads based on their recent LinkedIn activity (e.g. they recently posted about a specific topic).

| Filter Type             | Parameter                 | Additional Credits  |
| :---------------------- | :------------------------ | :------------------ |
| **Activity/Post Match** | `postInteractionKeywords` | +5 credits per lead |

***

## Company Insights & Search

Credit costs for Companies are based on a base insight fee plus any specific enrichments requested **per company**.

### Base & Enrichment Costs

| Item                      | Credits per company                     |
| :------------------------ | :-------------------------------------- |
| **Base Insight Cost**     | 1 credit                                |
| **Decision Makers**       | 0.5 credits per decision maker per role |
| **Job Postings Insights** | 5 credits per role                      |
| **Revenue**               | 5 credits                               |
| **Recent Funding**        | 5 credits                               |
| **Department Ratio**      | 4 credits per role                      |
| **Employee Count Change** | 4 credits per role                      |
| **Employee Count**        | 2 credits per role                      |
| **Technology Stack**      | 2 credits                               |
| **Custom Query**          | 0.2 credits per query                   |

### Decision Maker Contact Details

When requesting `decision_makers` with `includeContactDetails: true`, the same discount logic applies:

| Scenario                                   | Lead Cost | Contact Cost | Total Per Decision Maker |
| :----------------------------------------- | :-------- | :----------- | :----------------------- |
| **Decision Makers — no contact details**   | 0.5       | —            | **0.5**                  |
| **Decision Makers — with contact details** | 0.1       | +11          | **11.1**                 |

<Note>
  You are only charged for the number of decision-makers actually returned, up to your `decisionMakersLimit`.
</Note>

***

## How Credits Work

When you make an API request, we calculate the total credit cost based on your parameters. If your available credits are sufficient, we process the entire request. If not, we process as much as we can with your remaining credits and return the results for the processed items, indicating any skipped items.

## Checking Your Balance

You can check your remaining credit balance through multiple methods:

1. **Developer Dashboard**: View your real-time balance directly on the [Precept Developer Dashboard](https://app.preceptai.co.uk/developer).
2. **API Endpoint**: Perform a `GET` request to the `/v1/credits` endpoint to programmatically check your balance.
3. **MCP Tool**: If you are using our Model Context Protocol server, invoke the `precept_check_credits` tool.

## Testing Your Webhook

<Tip>
  A quick way to check the result endpoint and troubleshoot is to use a webhook
  URL from [webhook.site](https://webhook.site) (a free service).
</Tip>