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

# Transaction limit notifications

> Reference for transaction_limit_policy_breached webhook payloads sent when a crypto transfer breaches a policy, including policy scope, window, and threshold.

Bastion sends these notifications when identities in your organization breach transaction limit policies. See the [transaction limits page](/v2/api-reference/transaction-limits/overview) for more information about transaction limit policies.

## Transaction limit policy breached events

An example `Transaction Limit Policy Breached` event payload:

<CodeGroup>
  ```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
  {
    "id": "1czONudbZwh5siu2igQJY94QkFH:33TmBAsfebMrQi6QNE1ge1ecI70",
    "type": "transaction_limit_policy_breached",
    "data": {
      "policy": {
        "id": "1czONudbZwh5siu2igQJY94QkFH",
        "scope": "APP_SCOPED",
        "evaluation_window": "PER_TRANSACTION",
        "threshold_type": "HARD",
        "threshold_amount": "1234.12",
        "threshold_currency": "USD",
        "identity_id": "",
        "is_active": true,
        "created_at": "",
        "updated_at": ""
      },
      "identity_id": "33TmRnrHXVasjXfIQ2e9OBixtwM",
      "crypto_transfer_request_id": "1czONudbZwh5siu2igQJY94QkFH",
      "transferred_amount": "10000.00"
    }
  }
  ```
</CodeGroup>

| **Field**                          | **Type** | **Description**                                                                                                     |
| ---------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
| id                                 | string   | Unique identifier for each event. It can be used to deduplicate events.                                             |
| type                               | string   | The type of event. This is always `transaction_limit_policy_breached` for transaction limit policy breached events. |
| data.policy.id                     | string   | Unique identifier for the policy that was breached.                                                                 |
| data.policy.scope                  | string   | Scope of the policy that was breached. Valid values are `APP_SCOPED` and `IDENTITY_SCOPED`.                         |
| data.policy.evaluation\_window     | string   | Evaluation window of the policy that was breached. Valid values are `PER_TRANSACTION` or `PAST_WEEK`.               |
| data.policy.threshold\_type        | string   | Threshold type of the policy that was breached. Valid values are `HARD` or `SOFT`.                                  |
| data.policy.threshold\_amount      | string   | Threshold amount of the policy that was breached.                                                                   |
| data.policy.threshold\_currency    | string   | Threshold currency of the policy that was breached.                                                                 |
| data.policy.identity\_id           | string   | The identity ID that the breached policy applies to (only relevant for `IDENTITY_SCOPED` policies).                 |
| data.policy.is\_active             | boolean  | Indicates whether the breached policy is currently active or not. This should always be true.                       |
| data.policy.created\_at            | string   | The timestamp when the breached policy was created.                                                                 |
| data.policy.updated\_at            | string   | The timestamp when the breached policy was last updated.                                                            |
| data.identity\_id                  | string   | The ID of the identity that breached the transaction limit policy.                                                  |
| data.crypto\_transfer\_request\_id | string   | The ID of the cryptocurrency transfer request that triggered the policy breach.                                     |
| data.transferred\_amount           | string   | The amount transferred by the identity that breached the policy over the course of the policy's evaluation window.  |


## Related topics

- [Transaction limits API overview](/v2/api-reference/transaction-limits/overview.md)
- [Get Transaction Limit Policy](/v2/api-reference/transaction-limits/get-transaction-limit-policy.md)
- [List Transaction Limit Policies](/v2/api-reference/transaction-limits/list-transaction-limit-policies.md)
- [Crypto transfers and deposits](/guides/concepts/crypto-transfers.md)
- [Deposit notifications](/v2/api-reference/webhooks/notifications/deposit-notifications.md)