> ## Documentation Index
> Fetch the complete documentation index at: https://commet.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# balance.depleted

> A subscription ran out of prepaid balance.

## When this fires

The async usage processor fires this once when a deduction moves the prepaid balance from positive to zero or below. On plans that block on exhaustion, further usage is rejected with `insufficient_balance`; otherwise the balance goes negative and usage continues.

`customer.state_changed` fires alongside it with trigger `balance_depleted`.

Use it to cut off gated features or push an urgent top-up flow.


## OpenAPI

````yaml /openapi/en/webhooks/2026-08-27.json webhook balance.depleted
openapi: 3.1.0
info:
  title: Commet Webhooks
  version: '2026-08-27'
  description: >-
    Outbound webhook events emitted by the Commet API. Each event is delivered
    as a signed POST to your configured endpoints.
servers: []
security: []
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.