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

Заголовки запроса

Header	Required	Description
X-API-KEY	Да	Ваш API-ключ из панели управления Netts

Параметры строки запроса

Parameter	Type	Required	Default	Description
address	string	Да	—	Адрес в блокчейне (10-100 символов)
network	string	Да	—	Тикер блокчейн-сети (см. Поддерживаемые сети)
page	integer	Нет	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"
}

Поля ответа

Field	Type	Description
data.address	string	Запрошенный адрес
data.total	integer	Общее количество проверок для этого адреса
data.page	integer	Текущий номер страницы
data.pages	integer	Общее количество страниц
data.checks	array	Массив записей проверок (до 100 на страницу)

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

Field	Type	Description
client_order_id	string	ID заказа — используйте с GET /apiv2/aml/{order_id} для получения полного результата
provider	string	Провайдер AML: elliptic
status	string	completed, pending, processing, failed
created_at	string	Дата/время создания проверки
completed_at	string | null	Дата/время завершения проверки
risk_score	number | null	Оценка риска (Elliptic: 0-10). null, если не завершена
risk_level	string | null	low, medium или high
is_sanctioned	boolean | 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