📊 Получение проверки транзакции

GET /api/v1/tx-checks/{id}

Карточка проверки: статус, данные транзакции и разбивка риска по сторонам. Метод бесплатный — им и опрашивается результат.

🛠️ Параметры

Name	In	Type	Required	Description
id	path	integer	true	Идентификатор проверки из ответа на создание

Пример запроса

curl 'https://amlkyc.tech/api/v1/tx-checks/128' \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Accept: application/json'

Example responses

200 Response — проверка завершена

{
  "success": true,
  "data": {
    "id": 128,
    "uuid": "0f2d3a51-6f1a-4a2f-9f2f-2a5a0c9d7b41",
    "hash": "e54ca4ba8ff7034b1e11e764c50f65fdfc5fb0394fe986ec4d96aff2b4230598",
    "network": "trx",
    "status": 2,
    "status_label": "done",
    "score": 77,
    "summary": {
      "network": "trx",
      "hash": "e54ca4ba8ff7034b1e11e764c50f65fdfc5fb0394fe986ec4d96aff2b4230598",
      "block": 68123456,
      "contractRet": "SUCCESS",
      "timestamp": 1759132364000,
      "amount": "1500.000000",
      "asset": "USDT",
      "from": [
        "TLXvVN23UkxS4SW4JuQMhAYw9NNP8zwGyA"
      ],
      "to": [
        "TFq8GqCTiJA1PAnCJjtqDMHTRAsZgKNaYk"
      ]
    },
    "results": [
      {
        "address": "TLXvVN23UkxS4SW4JuQMhAYw9NNP8zwGyA",
        "direction": "in",
        "score": 77,
        "labels": [
          "Mixer"
        ]
      },
      {
        "address": "TFq8GqCTiJA1PAnCJjtqDMHTRAsZgKNaYk",
        "direction": "out",
        "score": 12,
        "labels": []
      }
    ],
    "error": null,
    "created_at": "2026-09-29T09:12:44.000000Z",
    "updated_at": "2026-09-29T09:13:58.000000Z"
  }
}

📋 Поля карточки

Поле	Тип	Описание
id	integer	Идентификатор проверки
uuid	string	UUID проверки
hash	string	Хеш транзакции в том виде, в каком его прислали
network	string	Сеть, подтвердившая транзакцию
status	integer	`0` — new, `1` — processing, `2` — done, `3` — failed
status_label	string	Текстовый статус: `new`, `processing`, `done`, `failed`
score	number\|null	Итоговый риск: максимум по отскоренным сторонам. `null`, пока проверка не завершена
summary	object\|null	Данные транзакции: `from`, `to`, `block`, `timestamp`, `amount`, `asset` и другие поля источника
results	array\|null	Разбивка риска по адресам сторон
error	string\|null	Код ошибки при статусе `failed`
created_at, updated_at	string	Даты в ISO 8601

🧩 Разбивка `results`

Поле	Тип	Описание
address	string	Адрес стороны транзакции
direction	string	`in` — отправитель (из `summary.from`), `out` — получатель (из `summary.to`)
score	number\|null	Риск адреса; `null`, если источники риска по нему не ответили
labels	array	Метки риска (строки), например `Mixer`, `Malicious Address`. Пустой массив, если меток нет

Скорится до 10 уникальных адресов транзакции: сначала отправители, затем получатели. Для «веерных» биткоин-транзакций с десятками входов это значит, что в results попадёт часть сторон, тогда как в summary.from и summary.to перечислены все.

Состав полей summary зависит от сети и источника данных: у EVM-сетей это одно, у биткоин-семейства и TRON — другое. Полагайтесь на from, to, amount и asset, остальные поля считайте дополнительными.

200 Response — проверка не удалась

{
  "success": true,
  "data": {
    "id": 129,
    "uuid": "6b0a31f8-2fc3-4e58-9a5f-8b58ef7e1c02",
    "hash": "0x2f1c0bd5ef1f1e9f0fbb5ee8b1b9a7a24d5a5de2b0a0a51a1f5f1f2c3d4e5f60",
    "network": "eth",
    "status": 3,
    "status_label": "failed",
    "score": null,
    "summary": {
      "network": "eth",
      "hash": "0x2f1c0bd5ef1f1e9f0fbb5ee8b1b9a7a24d5a5de2b0a0a51a1f5f1f2c3d4e5f60",
      "block": 21345678,
      "from": [
        "0x28c6c06298d514db089934071355e5743bf21d60"
      ],
      "to": [
        "0x21a31ee1afc51d94c2efccaa2092ad1028285549"
      ]
    },
    "results": [
      {
        "address": "0x28c6c06298d514db089934071355e5743bf21d60",
        "direction": "in",
        "score": null,
        "labels": []
      },
      {
        "address": "0x21a31ee1afc51d94c2efccaa2092ad1028285549",
        "direction": "out",
        "score": null,
        "labels": []
      }
    ],
    "error": "risk_sources_unavailable",
    "created_at": "2026-09-29T09:20:10.000000Z",
    "updated_at": "2026-09-29T09:21:02.000000Z"
  }
}

Расшифровка кодов — в разделе Коды ошибок. Возврата средств при failed нет, проверку можно запустить заново.

🔁 Ответы

Status	Meaning	Description
200	OK	Данные проверки
401	Unauthorized	Токен отсутствует или недействителен
403	Forbidden	Проверка транзакций не подключена аккаунту
404	Not Found	Проверка не найдена или принадлежит другому пользователю