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

# Usage Threshold Payload

All three usage threshold webhooks send the same payload. `alerting_target_type` tells you which kind of threshold was crossed, and it decides the unit of the two values.

| Field | Description |
| - | - |
| `webhook_run_id` | Salesbricks ID of this webhook run. |
| `subscription_id` | Salesbricks ID of the Subscription whose usage crossed the threshold. |
| `brick` | The usage brick: its `id`, `name`, and `code`. |
| `transaction_id` | The `transaction_id` of the usage record that pushed usage over the threshold, as you sent it to the [Usage API](/api-reference/usage/overview). |
| `alerting_target_type` | `pre-committed`, `units`, or `money`. |
| `alert_threshold_value` | The threshold you configured on the brick, as a decimal string. |
| `actual_usage_value` | Usage at the moment the threshold was crossed, as a decimal string. It is always greater than or equal to `alert_threshold_value`. |

The unit of `alert_threshold_value` and `actual_usage_value` depends on `alerting_target_type`:

| `alerting_target_type` | Unit | Example |
| - | - | - |
| `pre-committed` | Percent of the pre-commitment used | `"90.00"` is 90% |
| `units` | Units of the brick | `"1000.00"` is 1,000 units |
| `money` | The smallest unit of the order's currency, e.g. cents for USD | `"10000.00"` is \$100.00 |

## Example

```json JSON theme={null}
{
  "webhook_run_id": "00000000-0000-0000-0000-000000000000",
  "subscription_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "brick": {
    "id": "ffffffff-ffff-ffff-ffff-ffffffffffff",
    "name": "API Calls",
    "code": "api-calls"
  },
  "transaction_id": "txn_20260930_0042",
  "alerting_target_type": "units",
  "alert_threshold_value": "1000.00",
  "actual_usage_value": "1012.00"
}
```


## Related topics

- [usage.threshold.exceeded.money](/api-reference/webhooks/usage/threshold-exceeded-money.md)
- [usage.threshold.exceeded.units](/api-reference/webhooks/usage/threshold-exceeded-units.md)
- [usage.threshold.exceeded.precommitment](/api-reference/webhooks/usage/threshold-exceeded-precommitment.md)