Credits and billing
What each call costs, when you are charged, and how usage is metered.
The API is prepaid. You hold a balance of credits; each successful call deducts the credits that call costs. One credit is €0.01, so a 25-credit call is 25 cents.
Credits are bought in API management.
What each call costs
Only some endpoints declare a price
Eight operations set an explicit cost. Every other billable operation is charged the default of 10 credits — including reading and deleting your own lists and monitoring subscriptions. The table below is the full, current, measured price list.
| Cost | Endpoints |
|---|---|
| 1 credit | GET /search/companies, GET /search/persons, GET /search/suggestions |
| 10 credits | Company record, history, shareholders, investments, financials, recently founded, person record, all list operations, all monitoring operations, job status and results, document trigger |
| 25 credits | POST /search/companies/filter, GET /companies/{id}/contact, GET /companies/{id}/officer-contacts, GET /persons/{id}/contact |
GET /health is free and needs no key.
When you are charged
Credits are deducted before your request runs, and refunded if it fails. In practice:
2xx— charged.4xxand5xxraised by the endpoint — refunded, so a not-found company or a validation error costs you nothing.402— the call never ran; nothing was deducted.
Because the deduction happens first, a burst of concurrent requests can take your balance below what you expected before any of them return.
Running out
When your balance cannot cover a call, the API returns 402 and does not run it:
{
"detail": {
"error": "INSUFFICIENT_CREDITS",
"message": "Insufficient credits. This request costs 25 credits.",
"required_credits": 25,
"available_credits": 4
}
}Top up in the app; the new balance is live within a few seconds. You can also enable auto top-up so a balance that drops below a threshold is refilled automatically.
Seeing what you have used
Your balance and a breakdown by endpoint and by key are in API management.
The usage breakdown is currently unreliable and may render empty even when calls have been billed. Your balance is always correct; if the breakdown is blank, that is a display fault and not a sign that calls were free.
Making calls cheaper
- Search first, then read. Three searches cost less than one company record.
POST /search/companies/filtercosts 25 credits but returns up to 100 companies — far cheaper than 100 individual reads.- Cache by company
id. Ids are stable; the record behind them rarely changes. - Use monitoring instead of re-reading companies to detect change. One subscription replaces an indefinite polling loop.