Tracking usage
Every authenticated response includes two headers:Plans
Choose the Mini plan to start without paying: pay as you go, with no subscription and no credit card, using your 100 free sign-up credits. It is the best way to evaluate KonbiniAPI, build prototypes, and run personal projects. When you need more volume at a lower rate, choose a monthly plan.
See konbiniapi.com/pricing for the full comparison.
On the Mini plan, credits expire 12 months after your last purchase. On monthly plans, plan credits reset every billing cycle and do not roll over.
Plan credits and extra credits
Accounts on a monthly plan can have two kinds of credits:- Plan credits come with your subscription. They reset each billing cycle when your subscription renews, and unused plan credits do not roll over.
- Extra credits are bought separately in $20 bundles. They are available to any account, including Mini, and stay in your account until they expire.
Buying extra credits
Buy extra credits from the billing page in the dashboard. A bundle always costs $20, and what it contains depends on your plan:
Subscribers buy at their plan’s rate, up to 2x their monthly plan credits per billing period (Plus 50,000, Pro 110,000, Max 320,000; Ultra has no limit). Beyond that, extra credits are priced at the Mini rate of 5,000 per bundle.
Expiry
Extra credits last 12 months after your last purchase; buying again extends the date for your whole extra credit balance. They remain in your account if you cancel your subscription. Plan credits expire at the end of each billing cycle.When credits run out
If your account has no credits left, requests return a402 status with the error code credits_exhausted. To keep going, you can:
- buy extra credits in $20 bundles, which are available immediately,
- upgrade to a monthly plan with more credits, or
- wait for your plan to renew, if you are on a monthly plan.
Failed renewals
If a renewal payment fails, your plan credits are paused until the payment succeeds. Extra credits keep working in the meantime. Update your card in the dashboard and the payment is retried immediately.Cancelling
Cancelling a subscription stops renewal. Your plan credits stay usable until the end of the current billing period, then the account moves to the Mini plan. Any extra credits you hold remain until they expire.Refunds
Requests that fail due to validation errors, server errors, timeouts, or upstream platform issues do not consume credits:Rate limits
There are no per-second or per-minute rate limits. You can make concurrent requests freely. The only limit is your credit balance: when credits reach zero, requests return402.