List of Alerts

Returns the list of KYT alerts detected for transfers and risky entity interactions.

---

HTTP Request

GET /v1/alerts/

---

Query Parameters

Parameter	Type	Required	Description
client_id	string	No	ID of the client associated with the transfer.
risk_type	string	No	Risk type (e.g., origin_of_funds, sender_exposure, sender_entity, recipient_entity).
risk_level	string	No	Risk level. Possible values: low, medium, high, severe.
alert_status	string	No	Status of the alert. Allowed values: open, in_progress, awaiting_response, done.
created_from	datetime	No	Minimum creation timestamp.
created_to	datetime	No	Maximum creation timestamp.
occurred_from	datetime	No	Minimum timestamp of when the risk occurred.
occurred_to	datetime	No	Maximum timestamp of when the risk occurred.
network	string	No	Network code (e.g., BTC, ETH, TRX).
token_id	string	No	Token ID involved in the transfer.
token_symbol	string	No	Token symbol (e.g., USDT).
entity_category	string	No	Code of the risky entity category.
proximity	string	No	Type of proximity with the risky entity. Allowed: direct, indirect.
page	integer	No	Page number.
page_size	integer	No	Number of items per page.

Deprecated parameters: type, interaction, status — will be removed soon.

---

Response

A successful response returns HTTP 200 OK and an object containing pagination data and a list of alerts.

---

ALERT object

Field	Type	Description
id	string	ID of the alert.
created_at	timestamp	When the alert was created.
updated_at	timestamp|null	When the alert was last updated.
risk_level	string	Level of the associated risk.
risk_type	string	Type of associated risk.
risk_occurred_at	timestamp	When the risk occurred.
alert_status	string	Current alert status (open, in_progress, awaiting_response, done).
entity_interaction	object|null	Details of interaction with a risky entity. See ALERT_ENTITY_INTERACTION.
transfer	object|null	Transfer object associated with the alert.
fiat_currency	string	Fiat currency symbol (e.g., USD).

---

ALERT_ENTITY_INTERACTION structure

Field	Type	Description
entity_category	string	Code of the entity category.
proximity	string	Type of interaction. One of: direct, indirect.
value_in_fiat	float|null	Value in fiat currency.
value_share	float|null	Share of the entity category in the transfer.
rule	object	Rule that produced the alert. See RISK_RULE.

---

Example Response

{
  "page": 1,
  "page_size": 20,
  "total_pages": 1,
  "total_items": 11,
  "items": [
    {
      "id": "35e378e2-bbc3-40fa-ab15-f82ab3837d9a",
      "created_at": "2025-08-08T13:00:58.053446+03:00",
      "updated_at": null,
      "risk_level": "severe",
      "risk_type": "origin_of_funds",
      "risk_occurred_at": "2025-07-30T11:29:42+03:00",
      "alert_status": "open",
      "entity_interaction": {
        "entity_category": "sanctions",
        "proximity": "indirect",
        "value_in_fiat": 29.81,
        "value_share": 0.9932,
        "rule": {
          "rule_type": "origin_of_funds",
          "rule_sub_type": "indirect",
          "entity_category": "sanctions",
          "min_value_in_fiat": 10.0,
          "min_value_share": 0.2
        }
      },
      "transfer": {
        "id": "818c979b-6821-4fb3-8980-3f10e702066c",
        "client_id": null,
        "attempt_id": null,
        "registered_at": "2025-08-08T11:28:59.302452+03:00",
        "risk_level": "severe",
        "risk_score": 1.0,
        "network": "TRX",
        "token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "token_symbol": "USDT",
        "tx_status": "bound",
        "tx_hash": "da2b7289f340edbb20547944cbb2f02671a49f5a88ba357cb62582ab13afc4e0",
        "occurred_at": "2025-07-30T08:29:42Z",
        "input_address": "TP18BS6ZVV9MxtUjJwcpU3NcFMkZZaJU5c",
        "output_address": "TVU5jBHJSwFLRSFbuufGddW4B7kzNcmXyB",
        "direction": "incoming",
        "amount": 30.0,
        "value_in_fiat": 30.01
      },
      "fiat_currency": "USD"
    }
  ]
}

GET/v1/alerts/

API KEY ID

API KEY SECRET

Query params (JSON)

{ "page": 1, "page_size": 10, "proximity": "indirect", "entity_category": "atm", "token_symbol": "USDT", "token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "network": "TRX", "occurred_from": "2025-11-01", "occurred_to": "2025-11-01", "created_from": "2025-11-01", "created_to": "2025-11-01", "alert_status": "in_progress", "risk_level": "low", "risk_type": "origin_of_funds", "client_id": "d4d4b4d0-f2a7-4154-8d4a-f6cc769546e3" }

HTTP Request

Press "Send Request" to generate HTTP request.

HTTP …
{
  // Response will be shown here after the request.
}