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

# RiskControl Objects

> Learn about RiskControl objects in the Transactions API.

The following are objects in the `/transactions` endpoint related to the response from RiskControl Real-Time Decisioning:

* `issuer_processor`

* `riskcontrol_tags`

* `triggered_rules`

* `tags`

<h2 id="_issuer_processor_object">
  issuer\_processor object
</h2>

The `issuer_processor` object is part of the `fraud` object in the `/transactions` endpoint.

| Fields                                                                              | Description                                                                                                                                                                                                                                                             |
| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| score<br /><br />integer<br /><br />Conditionally returned                          | The risk score generated by RiskControl. This is either the Mastercard Decision Intelligence or Visa Advance Authorization transaction risk score, which is identical to the `network_transaction_risk_score` field.<br /><br />**Allowable Values:**<br /><br />0 - 99 |
| risk\_level<br /><br />string<br /><br />Conditionally returned                     | The fraud rating, or level of risk for the transaction.<br /><br />**Allowable Values:**<br /><br />`high`, `low`                                                                                                                                                       |
| rule\_violations<br /><br />array of strings<br /><br />Conditionally returned      | The rules violated by the transaction.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more rule violations                                                                                                                                           |
| recommended\_action<br /><br />string<br /><br />Conditionally returned             | The action recommended based on the fraud score.<br /><br />**Allowable Values:**<br /><br />`APPROVE`, `DECLINE`, `NOT_PERFORMED`                                                                                                                                      |
| riskcontrol\_tags<br /><br />array of objects<br /><br />Conditionally returned     | The RiskControl tags triggered by the transaction.<br /><br />**Allowable Values:**<br /><br />See the <a href="#_riskcontrol_tags_object">riskcontrol\_tags object</a>.                                                                                                |
| fraud\_score\_reasons<br /><br />array of strings<br /><br />Conditionally returned | Reasons for the fraud score.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more fraud score reasons                                                                                                                                                 |
| triggered\_rules<br /><br />array of objects<br /><br />Conditionally returned      | Rules triggered by the event.<br /><br />**Allowable Values:**<br /><br />See the <a href="#_triggered_rules_object">triggered\_rules object</a>.                                                                                                                       |

<h2 id="_riskcontrol_tags_object">
  riskcontrol\_tags object
</h2>

<Note>
  **Note**\
  This object will be deprecated in the future. Instead, use the `triggered_rules` object.
</Note>

When a rule from your own custom-defined operational models is triggered, it generates a tag for your downstream actions. This information, including the tag, rule name, and associated multiple values, is contained in the `riskcontrol_tags` object as part of the `fraud` object in the `/transactions` endpoint.

| Fields                                                               | Description                                                                                                                                     |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| values<br /><br />array of strings<br /><br />Conditionally returned | Values associated with the tag.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more tag values                               |
| tag<br /><br />string<br /><br />Conditionally returned              | Tag name defined in the rule definition in the Real-Time Decisioning dashboard.<br /><br />**Allowable Values:**<br /><br />255 char max        |
| rule\_name<br /><br />string<br /><br />Conditionally returned       | Name of the rule as defined in the Real-Time Decisioning dashboard that was triggered.<br /><br />**Allowable Values:**<br /><br />255 char max |

<h2 id="_triggered_rules_object">
  triggered\_rules object
</h2>

This object provides a list of rules triggered by a fraud event along with the information on tags and rule characteristics.

| Fields                                                               | Description                                                                                                                                     |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| rule\_name<br /><br />string<br /><br />Conditionally returned       | Name of the rule as defined in the Real-Time Decisioning dashboard that was triggered.<br /><br />**Allowable Values:**<br /><br />255 char max |
| tags<br /><br />array of objects<br /><br />Conditionally returned   | All the tags defined in the triggered rule.<br /><br />**Allowable Values:**<br /><br />See the <a href="#_tags_object">tags object</a>.        |
| alert<br /><br />boolean<br /><br />Conditionally returned           | Indicates if the rule triggered an alert.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                           |
| entity\_type<br /><br />string<br /><br />Conditionally returned     | The entity type where the triggered rule was defined.<br /><br />**Allowable Values:**<br /><br />Valid entity type                             |
| suppress\_alert<br /><br />boolean<br /><br />Conditionally returned | Indicates if the triggered rule has `suppress_alert` in the definition.<br /><br />**Allowable Values:**<br /><br />`true`, `false`             |

<h2 id="_tags_object">
  tags object
</h2>

This object provides a list of tags along with the names and values defined in the triggered rules.

| Fields                                                    | Description                                                                |
| --------------------------------------------------------- | -------------------------------------------------------------------------- |
| name<br /><br />string<br /><br />Conditionally returned  | Name of the tag.<br /><br />**Allowable Values:**<br /><br />255 char max  |
| value<br /><br />string<br /><br />Conditionally returned | Value of the tag.<br /><br />**Allowable Values:**<br /><br />255 char max |

<h2 id="_example">
  Example
</h2>

```json JSON expandable lines wrap theme={null}
"fraud": {
    "issuer_processor": {
        "score": 0,
        "risk_level": "low",
        "rule_violations": [
            "Three_Tag_Rule"
        ],
        "recommended_action": "APPROVE",
        "riskcontrol_tags": [
          {
            "values": [
                "false"
            ],
            "tag": "risk",
                "rule_name": "Three_Tag_Rule"
          },
          {
            "values": [
                "authorization",
                "testing webhook 2"
            ],
            "tag": "tag",
            "rule_name": "Three_Tag_Rule"
          }
        ],
        "fraud_score_reasons": [],
        "triggered_rules": [
          {
            "rule_name": "Three_Tag_Rule",
            "tags": [
              {
                "name": "tag",
                "value": "authorization"
              },
              {
                "name": "tag",
                "value": "testing webhook 2"
              },
              {
                "name": "risk",
                "value": "false"
              }
        ],
        "alert": true,
        "entity_type": "ACTING_USER",
        "suppress_alert": false
      }
    ]
  }
}
```