- Error type:
billing_error code:plan_balance_limit_reached- API version:
2026-08-27
What to do
Use the planBalanceLimit details to show what remains and when the window resets, or let the customer top up, which the limit never caps. The responsemessage, param, and details fields describe the condition observed by the specific operation.
Retry behavior
Retry after planBalanceLimit.resetsAt or once purchased balance covers the usage.Correlate the request
Keep thex-request-id response header when reporting or investigating this error. Platform records the same identifier in its request event, so Commet can locate the exact execution without customer data or credentials.