Auto Billing Reset
User
Auto Billing Reset
Configure automatic billing cycle resets when credit usage crosses a threshold
GET
Auto Billing Reset
Automatically reset your billing cycle when credit usage crosses a configurable threshold — so your scrapers never stall waiting for a manual reset. A rolling 24-hour cap protects against runaway spending.
Returns your current Auto Billing Reset configuration and live usage status.
How it works
When Auto Billing Reset is enabled, a background poller checks your credit usage periodically. Once your usage exceedsthreshold_pct, it triggers a billing cycle reset: your plan renews immediately (charging your card on file) and your credits are restored to zero consumed. The max_resets_per_24h cap limits how many times this can happen in any rolling 24-hour window.
If the payment fails (including 3D Secure cards, which cannot complete authentication unattended), the reset is suppressed for the rest of the current billing cycle and you receive a failure email.
Get settings
string
required
Your API authentication token. Value:
Token YOUR_API_KEYResponse fields
boolean
Whether Auto Billing Reset is currently active.
integer
Credit usage percentage that triggers a reset. Example:
80 (reset when 80% of credits are consumed).integer
Maximum number of automatic resets allowed in any rolling 24-hour window (1–10).
integer
Number of resets that have already fired in the current 24-hour window.
string | null
UTC timestamp when the current 24-hour window expires and the counter resets, or
null if no window is active.number | null
Your current credit usage as a percentage of your plan’s allowance, or
null if no active subscription.Update settings
string
required
Your API authentication token. Value:
Token YOUR_API_KEYstring
required
Must be application/json. Value:
application/jsonboolean
required
Enable or disable Auto Billing Reset.
integer
Credit usage percentage that triggers a reset. Must be between 1 and 100. Defaults to your current setting.
integer
Maximum automatic resets in any rolling 24-hour window. Must be between 1 and 10. Defaults to your current setting.
If you POST with
enabled: true and your usage is already above threshold_pct, an immediate reset is triggered.Code Examples
GET Response
200
POST Response
200