Credits
Successful predictions consume either paid credits or free-tier allowance. Manage balance and purchase credit packs in the dashboard.
How billing works
- If your account has a paid credit balance, successful calls debit credits first.
- When the paid balance is
0, successful calls use the free tier (if remaining). - When both are exhausted, billed endpoints return 402.
Failed requests (validation errors, unknown measurements, out-of-range lookups, auth failures) do not consume credits or free-tier calls.
Free tier
- 10 successful calls per rolling 24-hour window
- Free-tier success responses may include
remaining_free_calls - When exhausted, the error includes
resets_atso you know when the window refreshes
Cost per endpoint
| Endpoint | Cost per successful request |
|---|---|
POST /v1/predict | 1 credit (or 1 free call) |
POST /v1/predict/range | 1 per returned percentile |
POST /v1/predict/compare | 1 per returned country |
POST /v1/percentile-lookup | 1 credit (or 1 free call) |
POST /v1/connected-dimension | 1 credit (or 1 free call) |
Credit packs
Purchase packs from the dashboard. Typical pack sizes:
| Pack | Credits |
|---|---|
| Starter | 100 |
| Growth | 500 |
| Scale | 1000 |
Exact pricing is shown in the dashboard at purchase time.