{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Paddle.",
  "vendor": "paddle",
  "event": "usage_balance.depleted",
  "resource": "usage_balance",
  "url": "https://hookdeck.com/webhooks/paddle/events#usage_balance.depleted",
  "description": "Customer's usage balance reaches zero (usage billing beta)",
  "trigger": null,
  "listed_in": "https://developer.paddle.com/webhooks/usage-balances/usage-balance-depleted",
  "confidence": "documented",
  "schema_source": "from Paddle docs (example)",
  "identified_by": "event_type field in the body",
  "payload": {
    "provenance": "doc-example",
    "value_realism": "doc-example-values",
    "field_count": 19,
    "key_fields": [
      {
        "path": "occurred_at",
        "type": "string",
        "example": "2026-09-27T16:42:10.283806Z"
      }
    ],
    "delivery": {
      "title": "From Paddle docs",
      "content_type": "application/json",
      "headers": []
    },
    "body": {
      "event_id": "evt_01js2n02s4fr6a8gvfm5enq0as",
      "event_type": "usage_balance.depleted",
      "occurred_at": "2026-09-27T16:42:10.283806Z",
      "notification_id": "ntf_01js2n03f91aw3v7q6f7x55r3z",
      "data": {
        "id": "ubl_01h9zx4p8q2r5t7v9w1y3z5b7d",
        "customer_id": "ctm_01gw9m680k848184fpttwr0b7z",
        "usage_balance_unit_id": "ubu_01kw8ta2j8x5t7q4v9m1kd6phz",
        "balance": {
          "used": {
            "total": "10000",
            "subscription": "10000"
          },
          "remaining": {
            "total": "0",
            "subscription": "0"
          },
          "overage": {
            "total": "0"
          }
        },
        "created_at": "2026-09-02T10:00:00Z",
        "updated_at": "2026-09-27T16:42:10Z"
      }
    }
  }
}