GET /apiv2/aml/

Замінено на GET /apiv2/screening/

GET /apiv2/screening/{client_order_id} — це контракт версії 2. Цей ендпоінт продовжує працювати і не буде відкликаний без попередження.

Отримати статус і результат раніше надісланої AML-перевірки.

Усі мітки часу у відповіді вказані в UTC. Рядковий формат залишається без змін — "2026-09-09 23:01:44", без суфікса часового поясу.

URL ендпоінта

GET https://netts.io/apiv2/aml/{order_id}

Заголовки запиту

Заголовок	Обов'язковий	Опис
X-API-KEY	Так	Ваш API-ключ з панелі керування Netts

Параметри шляху

Параметр	Тип	Обов'язковий	Опис
order_id	рядок	Так	ID замовлення, отриманий від POST /apiv2/aml

Приклади запитів

cURL

curl -X GET https://netts.io/apiv2/aml/A4C666ABE24BD4A \
  -H "X-API-KEY: your_api_key" \

Python

import requests

order_id = "A4C666ABE24BD4A"
headers = {
    "X-API-KEY": "your_api_key",
}

response = requests.get(f"https://netts.io/apiv2/aml/{order_id}", headers=headers)
data = response.json()

result = data.get("data", {})
print(f"Status: {result.get('status')}")
print(f"Risk Score: {result.get('risk_score')}")
print(f"Risk Level: {result.get('risk_level')}")

Відповідь

Успішна перевірка (200 OK)

{
    "success": true,
    "data": {
        "client_order_id": "A4C666ABE24BD4A",
        "status": "completed",
        "address": "TXtARC75jmh7sDDfHFunLbpA44T7JhJ53u",
        "provider": "elliptic",
        "report_language": "en",
        "risk_score": 10.0,
        "risk_level": "high",
        "is_sanctioned": false,
        "created_at": "2026-03-10 09:56:31",
        "completed_at": "2026-03-10 09:56:32",
        "result": {
            "risk_score": 10,
            "cluster_entities": [
                {
                    "name": "ChangeHero",
                    "category": "Coin Swap Service"
                }
            ]
        },
        "sanctions": {
            "self": false,
            "self_entities": null,
            "exposure": null,
            "items": []
        }
    },
    "timestamp": "2026-03-10 10:00:00"
}

Об'єкт sanctions дозволяє відрізнити підсанкційну адресу від тієї, яка лише пов'язана з підсанкційною сутністю. Його поля описані на сторінці перевірки.

Перевірка в процесі обробки (200 OK)

{
    "success": true,
    "data": {
        "client_order_id": "A4C666ABE24BD4A",
        "status": "pending",
        "address": "TPCHni9H51NEr8iT6fNJgkdMUBPbF79HBV",
        "provider": "elliptic",
        "report_language": "en",
        "message": "AML check is being processed",
        "estimated_time_seconds": 5,
        "created_at": "2026-03-10 09:56:31"
    },
    "timestamp": "2026-03-10 09:56:35"
}

Замовлення не знайдено (404)

{
    "success": false,
    "error": {
        "code": 4040,
        "message": "Order not found"
    },
    "timestamp": "2026-03-10 10:00:00"
}

Примітки

• Опитуйте цей ендпоінт для отримання результатів асинхронних перевірок (надісланих без wait: true)
• Типовий час завершення перевірки: 2-10 секунд
• Опитування не тягне за собою додаткових витрат