# Credits & costs

What each action spends, from the live credit table. Previews are free.

One balance covers the app, MCP and REST. You pay for a row that is returned. A miss is free. The numbers below are the live credit table. `GET /usage` returns `balance` and `today.credits_remaining`. A paid response repeats the charge in `X-Credits-Used` and `X-Credits-Charged`, and sends `X-Credits-Remaining` when the wallet can be read.

## Per action

- **Company with a buying signal** — 1 credit (`funding_company`, and a company row on an event).
- **Company using a technology** — 20 credits (`tech_company`).
- **Event lookup** — 0 credits (`event`).
- **Person, before a buyer profile** — 5 credits. That covers engagement, a new role, a mention, an event person (raw rows: no AI judged them), and `POST /leads` (`leads_person`).
- **Person from Search People** — 1 credit per person, charged per page of 25 (`person_search_row`): a page with results is 25 credits, however many people it holds. An empty page is free.
- **Qualified lead** — 20 credits (`screened_exact_lead`). Exact fit on a screened search.
- **Just outside** — 5 credits (`screened_close_match`).
- **Full profile** — 2 credits (`enrich_profile`), only when a profile is returned.
- **Work email** — 10 credits on top of the profile when an address is found. Together that is 12 (`enrich_email`).
- **Company enrich** — 1 credit (`company_enrich`).
- **Email and phone** — 40 credits, in the app, only when the phone is found. `POST /person/enrich` has `include_email` and no phone field.

`lookup_company`, `explain_lead`, `get_search_results`, `list_mentions`, and every `/preview` route are free. Creating a monitor is free. A monitor run charges the mention price above.

## preview_cost and max_credits

`preview_cost` takes `endpoint` `searches`, `leads`, `person.enrich` or `monitors`, and the body you would have sent. It returns `credits_per_row`, `max_rows`, `max_credits` and `period` (`call` or `day`). Nothing is fetched.

The same `max_credits` field on the real call stops before the next row would pass it (`truncated_by` `max_credits`). Below the cost of one row the call is `402` `max_credits_exceeded` and nothing runs. On people search and people enrich, `max_credits` is accepted only when the Signals API is open.

Usage for the key is [Get Usage](/docs/api-reference/usage), which is free.
