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

# Credits

> How credits work and when they reset.

## What is a credit?

One credit = **one researched prospect**. It costs the same wherever the research
was started from, and it is one pool for the whole account:

| Started by | Costs |
| - | - |
| `POST /research` (API) | 1 credit |
| A research in the Chrome extension | 1 credit |
| An automatic research from a calendar meeting | 1 credit per meeting — one attendee, not the whole room |
| A lead matching an Autopilot filter | 1 credit |

A credit is consumed whether the result comes from cache or from live lookups.

## What is free

* A lead that matched no Autopilot and was **abandoned** — no research, no credit
* A lead skipped by *Addresses to skip* or *Excluded domains*
* A contact re-created or re-fired by HubSpot, while **Research each contact only
  once** is on (the default)
* Sending, retrying, skipping or rescheduling any outreach message
* Polling `GET /research-status`

## Credit reset

Credits reset at the start of your **billing cycle** — the same day each month
as when you first subscribed. You'll see the exact reset date on your
[Analytics](https://call-prep-api.vercel.app/analytics) page.

Unused credits **do not roll over** to the next month.

## Monitoring usage

You can track your credit usage in real time:

* **Sidebar** — remaining credits shown in the dashboard sidebar
* **Analytics page** — daily usage chart and credit donut

## Credit alerts

Enable email notifications at 75% and 95% usage in
[Settings → Notifications](https://call-prep-api.vercel.app/settings).

## Cache hits still consume credits

When a research request returns cached data (response in under 2 seconds),
1 credit is still consumed. This is intentional — you're using the service
and the cached data was paid for on a previous request.

## Credit refunds

Credits are refunded automatically if a research job fails due to an infrastructure error
(timeout, pipeline crash). Credits are **not** refunded when:

* The prospect wasn't found in any data source
* The AI step failed but other data was returned
* You submitted an invalid email

If you believe a credit was incorrectly consumed, contact
[hello@callprep.app](mailto:hello@callprep.app) with the `research_id`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.