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

# Credits

> Understand which Leadsforge API operations consume credits, how credits are reserved and charged, and how to read your balance and prices.

Paid Leadsforge API operations consume credits from your account balance, the same balance you use in the Leadsforge app. Enrichment and the other paid operations charge for results, not for attempts: a lookup that finds nothing costs nothing. Search, count and lookalike preview are the exception: past their monthly free allowance, each successful call costs credits, whatever it returns.

## Prices and balance

Prices are set per account and per kind of result, so they are not listed here. Read your balance and your own prices from `GET /balance`:

* **Available credits**: what your account has left. It is capped by the API key owner's own credit limit, if their workspace sets one.
* **Reserved credits**: credits currently held by running requests and jobs. Available credits do not subtract them. Reserved credits cover the whole account while available credits can be capped by your own limit, so available minus reserved is an estimate of what you can spend right now.
* **Prices**: one price each for email, phone and LinkedIn enrichment, lookalike companies, company followers, maps discovery, and maps owner email and phone.

## Free and paid operations

| Operation | Cost |
| - | - |
| Filter values, location suggestions | Free |
| Search, count, lookalike company preview | Free up to a monthly allowance, then a fixed price per call |
| Reading jobs, results and the balance | Free |
| Email, phone and LinkedIn enrichment | Your price for the channel, per value found |
| Lookalike company search | Your lookalike price, per company returned |
| Company followers search | Your followers price, per follower collected |
| Maps discovery search | Your maps discovery price, per business found |
| Maps owner enrichment | Your maps owner email and phone prices, per contact found |

## Monthly free allowance

Search, count and lookalike preview are free up to a monthly allowance, counted per account across all of its API keys and reset at the start of each calendar month (UTC). Each search page counts as one search request, including pages fetched with a cursor. Requests that fail, including rate-limited ones, do not count.

Past the allowance, each successful call costs credits. If your balance does not cover it, the call fails with `402 insufficient_credits`, and while credit spending is paused it fails with `403 account_frozen`. `GET /balance` does not report how much of the allowance is left.

## Reservations

Operations that can spend a lot at once reserve credits before they start and settle when they finish:

1. The request reserves what it is expected to cost. If your available credits, minus what is already reserved, do not cover it, the request fails with `402 insufficient_credits` and nothing starts.
2. The operation runs.
3. You are charged for what it actually returned, and the rest of the reservation is released.

| Operation | What is reserved |
| - | - |
| Enrichment job | The channel price for every person whose value has to be looked up |
| Lookalike company search | The lookalike price for a full page |
| Company followers search | The followers price for the smaller of your limit and the company page's follower count |
| Maps discovery search | The maps discovery price for your limit |
| Maps owner enrichment | For businesses that need a new owner search: the maximum number of owners per business you request (`maxResults`) times the price of each requested channel |

The maps owner reservation is not an upper bound. Owners already found recently for the same places in your account, by this search or an earlier one, are reused and hold nothing, but their missing email or phone is still looked up and charged at the same prices, so a job can consume more than it reserved.

## Values your account already obtained

When your account obtained an email, phone number or LinkedIn URL for a person in the last 30 days, through the API or the app, enrichment returns it again for free and does not reserve credits for it. An older value is looked up again and charged if it is found. Getting such a value again does not extend the 30 days.

## Related resources

* [Search and enrichment](https://developer.salesforge.ai/leadsforge-api/concepts/search-and-enrichment.md)
* [Asynchronous jobs](https://developer.salesforge.ai/leadsforge-api/concepts/async-jobs.md)
* [Errors](https://developer.salesforge.ai/leadsforge-api/concepts/errors.md)


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