# Check transaction risks

The method allows you to check the risks of a completed transaction.

This request can be executed for several seconds. It is not recommended to set timeout less than 15 seconds.

### Request:

| **Parameter** | **Required** | **Type** | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------- | ------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| tx            | Yes          | String   | Transaction hash                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| currency      | Yes          | String   | Currency                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| network       | Yes          | String   | Network                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| outputAddress | Yes          | String   | Recipient address of coins                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| direction     | Yes          | String   | <p>The side to check the risks. Takes the value <code>sent</code> or <code>received</code>.<br><br>The <code>sent</code> value should be passed if a withdrawal transaction was made from your address. Then the risks of the completed transaction from the side of the sender will be checked<br><br>The <code>received</code> value should be passed if a deposit was made to your address. Then the risks of receiving coins to your address will be checked</p> |

### Response:

| **Parameter**        | **Type**       | **Description**                                                                                                                                                                                                                                                    |
| -------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| level                | String         | Risk level                                                                                                                                                                                                                                                         |
| categories           | String         | Array with risk categorization                                                                                                                                                                                                                                     |
| categories.level     | String         | Risk level in this category                                                                                                                                                                                                                                        |
| categories.usdAmount | Number         | The amount in USD that is associated with this risk category                                                                                                                                                                                                       |
| categories.category  | String or null | Category name                                                                                                                                                                                                                                                      |
| categories.service   | String or null | A service that is associated with this risk category                                                                                                                                                                                                               |
| categories.exposure  | String         | <p><code>DIRECT</code> - direct connection ("dirty" coins were sent from the attacker's address to the recipient's address directly)<br><br><code>INDIRECT</code> - indirect connection (the coins were marked risky, but passed through a chain of addresses)</p> |

The `level` parameter can take the following values:

* `white` - no risk
* `green` - low risk
* `yellow` - medium risk
* `red` - high risk
* `black` - severe risk

{% openapi src="<https://615678623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa1TzfeK1Z0GLFNxiNpMW%2Fuploads%2Fgit-blob-8361e5ac3780661a20a51ec0d96901ce1db69b92%2Fopenapi.json?alt=media>" path="/api-gateway/kyt/check-transfer" method="post" %}
[openapi.json](https://615678623-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa1TzfeK1Z0GLFNxiNpMW%2Fuploads%2Fgit-blob-8361e5ac3780661a20a51ec0d96901ce1db69b92%2Fopenapi.json?alt=media)
{% endopenapi %}
