Credits

Some operations consume workspace credits. This page explains which, how the charge is computed, and how to handle running out.

What charges credits#

Only POST /exports charges credits. Searching the index, fetching company detail, checking your balance, and polling or downloading an export are all free.

The per-row model#

Creating an export charges 1 credit per newly-exported company. Companies your workspace has exported before are deduplicated and re-exported for free, so re-running an overlapping export costs only the new rows. The create response breaks this down: requested_count, already_unlocked, new_count, and credits_charged.

Insufficient credits#

If your workspace doesn't have enough credits to cover the new rows, POST /exports returns 402 with code insufficient_balance. No export is created and no credits are charged. Top up and retry.

Buying credits

Purchasing is done in the web app at Account → Credits. There is no programmatic purchase endpoint yet.

Checking your balance#

Before a large export, check the balance with GET /credits so you can fail early or top up:

curl -X GET https://api.cornect.io/api/v1/credits \
  -H "Authorization: Bearer cornect_your_token_here"

For cost estimation + usage tracking, see the Credit Consumption guide.