GET /apiv2/aml/history

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

GET /apiv2/screening/history використовує пагінацію за курсором замість номера сторінки, тому записи не зміщуються під час читання; кожен фільтр є необов'язковим, а пропущені перевірки включено. Цей ендпоінт продовжує працювати і не буде відкликаний без попередження.

Отримання історії перевірок AML для конкретної адреси. Повертає лише перевірки, що належать автентифікованому користувачу. З пагінацією: 100 елементів на сторінку, спочатку новіші.

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

URL ендпоінту

GET https://netts.io/apiv2/aml/history?address=<ADDRESS>&network=<NETWORK>&page=1

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

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

Параметри запиту

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
address	рядок	Так	—	Адреса блокчейну (10-100 символів)
network	рядок	Так	—	Тікер блокчейн-мережі (див. Підтримувані мережі)
page	ціле число	Ні	1	Номер сторінки (починаючи з 1, 100 елементів на сторінку)

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

cURL

curl -X GET "https://netts.io/apiv2/aml/history?address=TPCHni9H51NEr8iT6fNJgkdMUBPbF79HBV&network=trx&page=1" \
  -H "X-API-KEY: your_api_key"

Python

import requests

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

response = requests.get(
    "https://netts.io/apiv2/aml/history",
    headers=headers,
    params={
        "address": "TPCHni9H51NEr8iT6fNJgkdMUBPbF79HBV",
        "network": "trx",
        "page": 1
    }
)
data = response.json()

if data["success"]:
    print(f"Total checks: {data['data']['total']}")
    print(f"Page {data['data']['page']} of {data['data']['pages']}")
    for check in data["data"]["checks"]:
        print(f"  {check['created_at']} | {check['client_order_id']} | "
              f"{check['provider']} | risk={check['risk_score']} ({check['risk_level']})")

Відповідь

Успішно (200 OK)

{
    "success": true,
    "data": {
        "address": "TPCHni9H51NEr8iT6fNJgkdMUBPbF79HBV",
        "total": 250,
        "page": 1,
        "pages": 3,
        "checks": [
            {
                "client_order_id": "A4C666ABE24BD4A",
                "provider": "elliptic",
                "status": "completed",
                "created_at": "2026-03-10 15:00:00",
                "completed_at": "2026-03-10 15:00:05",
                "risk_score": 10.0,
                "risk_level": "high",
                "is_sanctioned": false
            },
            {
                "client_order_id": "A7F3B2E1D9C04A6",
                "provider": "elliptic",
                "status": "completed",
                "created_at": "2026-03-09 12:30:00",
                "completed_at": "2026-03-09 12:30:08",
                "risk_score": 0.85,
                "risk_level": "high",
                "is_sanctioned": false
            }
        ]
    },
    "timestamp": "2026-03-10 15:05:00"
}

Немає результатів (200 OK)

{
    "success": true,
    "data": {
        "address": "TXtARC75jmh7sDDfHFunLbpA44T7JhJ53u",
        "total": 0,
        "page": 1,
        "pages": 0,
        "checks": []
    },
    "timestamp": "2026-03-10 15:05:00"
}

Поля відповіді

Поле	Тип	Опис
data.address	рядок	Запитувана адреса
data.total	ціле число	Загальна кількість перевірок для цієї адреси
data.page	ціле число	Поточний номер сторінки
data.pages	ціле число	Загальна кількість сторінок
data.checks	масив	Масив записів перевірок (до 100 на сторінку)

Поля запису перевірки

Поле	Тип	Опис
client_order_id	рядок	ID замовлення — використовуйте з GET /apiv2/aml/{order_id} для отримання повного результату
provider	рядок	Провайдер AML: elliptic
status	рядок	completed, pending, processing, failed
created_at	рядок	Дата/час відправлення перевірки
completed_at	рядок | null	Дата/час завершення перевірки
risk_score	число | null	Оцінка ризику (Elliptic: 0-10). null, якщо не завершено
risk_level	рядок | null	low, medium або high
is_sanctioned	логічний | null	true, якщо виявлено санкційні ризики

Пагінація

• Кожна сторінка повертає до 100 записів, відсортованих за датою (спочатку новіші)
• Використовуйте total, щоб дізнатися, скільки перевірок існує для цієї адреси
• Використовуйте pages, щоб дізнатися номер останньої доступної сторінки
• page=1 повертає 100 найновіших перевірок, page=2 — наступні 100 і так далі.

Відповіді з помилками

Помилка автентифікації (401)

{
    "detail": {
        "code": -1,
        "msg": "API key not provided"
    }
}

Недійсна мережа (400)

{
    "success": false,
    "error": {
        "code": 4002,
        "message": "Unsupported network: xyz. See supported networks list."
    }
}

Примітки

• Повертаються лише ваші власні перевірки — ви не можете бачити перевірки, здійснені іншими користувачами для тієї самої адреси
• Перевірки зі статусом skipped (неактивні адреси) виключаються з історії
• Щоб отримати повний результат для будь-якої перевірки, використовуйте GET /apiv2/aml/{order_id} з client_order_id