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

# Credits

> Understand how credits work, what costs credits, and what's free.

## How credits work

Every Encrata workspace has a credit balance. Most enrichment endpoints consume 1 credit per request. Some endpoints are completely free.

Credits are deducted **after** a successful response — if a lookup fails (502, 503), you're not charged.

## Credit costs

### Paid endpoints (1 credit each)

| Endpoint             | Description                                                                                                                                                    |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/api/agent/lookup`  | Full email enrichment                                                                                                                                          |
| `/api/agent/google`  | Google search                                                                                                                                                  |
| `/api/agent/company` | Company intelligence                                                                                                                                           |
| `/api/agent/domain`  | Domain WHOIS + knowledge graph                                                                                                                                 |
| `/api/agent/ip`      | IP intelligence — geolocation, threat, ports/CVEs, WHOIS, blocklists, BGP, passive DNS, reputation history, routing history, TLS/JARM, C2 & honeypot detection |
| `/api/agent/phone`   | Phone number intelligence                                                                                                                                      |
| `/api/agent/darkweb` | Dark web search (1 credit per 100 results)                                                                                                                     |

### Free endpoints (0 credits)

| Endpoint                            | Description                |
| ----------------------------------- | -------------------------- |
| `/api/agent/validate`               | Email deliverability check |
| `/api/agent/breaches`               | Breach history lookup      |
| `GET /api/agent/monitors`           | List/get monitors          |
| `POST /api/agent/monitors`          | Create monitor             |
| `GET /api/agent/monitoring/runs`    | List runs                  |
| `GET /api/agent/monitoring/results` | List results               |
| `GET /api/agent/lists`              | List contact lists         |
| `GET/POST /api/webhooks`            | Webhook management         |
| `GET /api/health`                   | Health check               |

### Bulk & monitor runs

| Operation                       | Cost                               |
| ------------------------------- | ---------------------------------- |
| Bulk lookup (up to 1000 emails) | 1 credit per successful enrichment |
| Monitor run trigger             | 1 credit per target in the monitor |

<Note>
  Dark web search charges 1 credit per 100-result page. A search returning 250 results costs 3 credits (pages 0–99, 100–199, 200–249).
</Note>

## Checking your balance

Your current credit balance is visible in the [dashboard](https://encrata.com/billing).

## Insufficient credits

When you don't have enough credits, the API returns:

```json theme={"dark"}
{
  "error": "Insufficient credits"
}
```

With HTTP status `402 Payment Required`.

## Webhook alerts

Set up webhooks to get notified about credit usage:

| Event               | Trigger                                      |
| ------------------- | -------------------------------------------- |
| `credits.low`       | Credits drop below your configured threshold |
| `credits.exhausted` | Credits reach zero                           |

See [Webhooks](/webhooks) to configure these alerts.

## Tips

<CardGroup cols={2}>
  <Card title="Use free endpoints first" icon="circle-check">
    Validate emails before enriching — skip invalid addresses to save credits.
  </Card>

  <Card title="Select fields" icon="filter">
    Use the `fields` parameter to request only what you need. Reduces response size (same credit cost, but faster).
  </Card>

  <Card title="Use monitors for recurring" icon="clock-rotate-left">
    Instead of manual re-lookups, set up monitors — they only charge for actual enrichment runs.
  </Card>

  <Card title="Bulk for volume" icon="layer-group">
    Bulk endpoints have the same per-item cost but lower rate limits, making high-volume work easier.
  </Card>
</CardGroup>