Credits & billing
How Kausate charges credits, which calls are free, when an order is charged and what happens when credits run out.
Kausate charges for data in credits. Each billable action, such as a company report or a document, has a credit price for your organization. Your organization pays for credits under its agreement with Kausate; this page explains how they are used, not what they cost.
How actions are priced
An action is priced in one of four ways:
| Pricing | Meaning |
|---|---|
| Fixed | A set number of credits per call. With a tiered agreement, the price per call depends on your usage in the period. |
| Variable | The cost depends on the result, around a typical amount. |
| Bundled | One charge per company per calendar month (UTC), however often you order it in that month. |
| Free | The action costs nothing. |
What is charged
Orders for company data are charged: live search, prefill, company reports, documents, financials, shareholder graphs and their extensions, UBO reports and monitoring checks.
These calls are free:
- Autocomplete.
- Listing a company's documents.
- Polling an order's status and result.
- Quoting a shareholder graph extension.
- Search and data calls against the sandbox. Monitors on sandbox companies are billed like any monitor.
Prefill is free for some companies. A free prefill is recorded in your usage with 0 credits.
When an order is charged
An order is charged once it has its result. If it fails or is cancelled, you are not charged: a charge already recorded is reversed with a refund.
A shareholder graph extension is charged per company it extends, at the price for that company's jurisdiction. Each company is charged as the extension reaches it and refunded if it fails. Quote the extension to see the exact cost first.
Repeated orders
The same report, ownership, financials or document order for the same company
on the same UTC day returns the existing order and is not charged again. Orders
match when they have the same endpoint, company, parameters and customer ID.
Set bypassCache to order fresh data, which is charged again. A failed order is
never reused. Live search orders are never reused: each one runs again. See
Daily deduplication.
Charges per customer
Send X-Customer-Id with an order to record its charge against one of your own
customers. The same company ordered for two customer IDs is two orders and two
charges. See Authentication.
Balance and credit limit
Credits arrive as grants, bought or granted, and a grant can have an end date. Charges use the grant that ends first. Bought credits do not expire.
A prepaid account uses credits granted or bought in advance. A postpaid account can go on using credits beyond its grants, up to a monthly credit limit, and that usage is invoiced afterwards.
When your organization has used its credits or reached its credit limit, new
paid orders return HTTP 403 with code billing.credit_limit_exceeded. Free
calls keep working. Orders already running finish and are charged, so a balance
can briefly fall below zero. The block applies within a few minutes of reaching
the limit, and lifts the same way once credits are added.
Last updated on