Every error

Daily spending cap reached

This Account reached its daily spending cap, so the call did not start. Nothing charged.

FactValue
HTTP status429
Typehttps://docs.investorliftdata.com/errors/spend-cap-exceeded
ChargedNothing is charged by a call that ends here.
RetryRetry once earlier calls leave the rolling window, or ask support to raise the cap.

Common causes

  • Earlier calls have used the available allowance in the rolling window.
  • This call costs more than the entire cap allows.
  • A connected assistant reached its own limit for the window; cap_scope is connection.

How to fix

  1. Wait, or change the cap in Billing.
  2. Compare cap, consumed, required and window_seconds in the body.
  3. Slowing down alone does not raise the cap; a call larger than the cap cannot fit by waiting.

Example response body

JSONCode
{ "type": "https://docs.investorliftdata.com/errors/spend-cap-exceeded", "title": "Daily spending cap reached", "status": 429, "detail": "This Account has reached its Spend Cap, the most it may spend in a rolling window, so this Metered Call was not started and nothing was charged. The Spend Cap, the amount already spent in the window, the amount this call requires, and the length of the window in seconds are given below. The window rolls continuously rather than resetting on a clock boundary: send the request again once earlier calls have fallen outside it, or contact support to have the Spend Cap raised.", "trace_id": "00000000-0000-4000-8000-000000000000", "cap": 250.00, "consumed": 250.00, "required": 1.00, "window_seconds": 3600, "cap_cents": 25000, "consumed_cents": 25000, "required_cents": 100, "cap_scope": "account" }

Extra body members

MemberMeaning
capThe cap that refused the call — the most this Account (or, when cap_scope is connection, this one assistant connection) may spend in one rolling window, in US dollars (two decimals, for example 250.00).
consumedWhat has already been spent in the window against that cap (by this Account, or by this one assistant connection when cap_scope is connection), in US dollars (two decimals). Every Metered Call counts, including calls whose price was later returned to the balance.
requiredWhat this call costs, in US dollars (for example 1.00).
window_secondsThe length of the window in seconds. The window rolls continuously rather than resetting on a clock boundary, so room to spend becomes available again as earlier calls fall outside it.
cap_centsThe same figure as cap, in whole US cents (for example 25000).
consumed_centsThe same figure as consumed, in whole US cents.
required_centsThe same figure as required, in whole US cents (for example 100).
cap_scopeWhich cap refused the call: account — the account's spending cap; connection — one assistant connection's own limit.

Quote the trace_id to support@investorliftdata.com.

Last modified on