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

# Credits and limits

> What costs credits, when they refill and how many requests you can make.

## Credits

| Action | Cost |
| - | - |
| Search (person or company) | 1 credit per returned full record |
| Lookup (person or company) | 1 credit per returned full record |
| Enrichment | 1 credit per returned full record; unmatched inputs are free |
| Previews, empty results, usage and billing tools | Free |
| Monthly refill | 1st of each month (UTC) |

* Ten returned full records cost 10 credits. Each new full retrieval is charged again, including repeated searches.
* If your balance can't cover the entire page, no records are returned and nothing is deducted. Lower `limit` to fit your balance.
* If a paid search can't confirm its charge or response, check `account_usage` before retrying; a committed debit can survive a lost response.
* Unused monthly credits don't roll over. Credits from packs never expire and are spent after your monthly credits.
* We email you when 20% of your monthly credits are left, and again if you run out.
* Plans and prices are on the [pricing page](https://enricho.co/pricing).

## Rate limits

| Limit | Value |
| - | - |
| MCP requests per account, across connected clients | 60 per minute |
| Direct REST requests per API key at the gateway | 60 per minute |
| Authentication requests per API key | 120 per minute |
| Authentication requests per account, across all keys and connected apps | 300 per minute |
| Gateway requests per source IP, shared across clients | 600 per minute |

These limits are cumulative: creating another key or connecting another client does not bypass account or IP limits. Going over a request limit returns `429 Too Many Requests`. Pause before retrying and respect `Retry-After` when it is present. The authentication limits are additional protections, not extra API capacity.

## Free previews

Previews of people and companies share one daily allowance per account, reset at midnight UTC.

| Plan | Free previews per day |
| - | - |
| Free | 100 |
| Pro | 1,000 |
| Growth | 5,000 |
| Scale | 20,000 |
| Enterprise | 20,000 |

The allowance counts **preview requests, not returned rows**, and is shared across keys and clients. A preview is an unpaginated sample of up to 10 records without contact values or an exact result count.

Preview requests cannot exclude person IDs or company IDs. You may exclude up to **10 company domains**; larger exclusions require a full search.

Over the allowance, previews return `429`; wait until midnight UTC for more free previews, or explicitly authorize a full search (1 credit per returned record). Request rate limits still apply to full searches. Invalid preview requests do not consume the daily allowance.


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