GET /apiv2/aml/history

Reemplazado por GET /apiv2/screening/history

GET /apiv2/screening/history pagina mediante cursor en lugar de número de página, por lo que los registros no se desplazan mientras lee; cada filtro es opcional y se incluyen las verificaciones omitidas. Este endpoint sigue funcionando y no se retirará sin previo aviso.

Obtenga el historial de verificaciones AML para una dirección específica. Solo devuelve verificaciones pertenecientes al usuario autenticado. Paginado: 100 elementos por página, los más recientes primero.

Todas las marcas de tiempo en la respuesta están en UTC. El formato de cadena no cambia: "2026-09-09 23:01:44", sin sufijo de zona.

URL del endpoint

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

Encabezados de solicitud

Header	Required	Description
X-API-KEY	Yes	Su clave API del panel de Netts

Parámetros de consulta

Parameter	Type	Required	Default	Description
address	string	Yes	—	Dirección de blockchain (10-100 caracteres)
network	string	Yes	—	Ticker de la red blockchain (consulte Redes compatibles)
page	integer	No	1	Número de página (basado en 1, 100 elementos por página)

Ejemplos

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']})")

Respuesta

Éxito (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"
}

Sin resultados (200 OK)

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

Campos de respuesta

Field	Type	Description
data.address	string	Dirección consultada
data.total	integer	Número total de verificaciones para esta dirección
data.page	integer	Número de página actual
data.pages	integer	Número total de páginas
data.checks	array	Arreglo de registros de verificación (hasta 100 por página)

Campos del registro de verificación

Field	Type	Description
client_order_id	string	ID de la orden — utilícelo con GET /apiv2/aml/{order_id} para obtener el resultado completo
provider	string	Proveedor de AML: elliptic
status	string	completed, pending, processing, failed
created_at	string	Fecha/hora de envío de la verificación
completed_at	string | null	Fecha/hora de finalización de la verificación
risk_score	number | null	Puntuación de riesgo (Elliptic: 0-10). null si no se ha completado
risk_level	string | null	low, medium, o high
is_sanctioned	boolean | null	true si se detectó exposición a sanciones

Paginación

• Cada página devuelve hasta 100 registros, ordenados por fecha (los más recientes primero)
• Utilice total para saber cuántas verificaciones existen para esta dirección
• Utilice pages para saber el último número de página disponible
• page=1 devuelve las 100 verificaciones más recientes, page=2 las siguientes 100, etc.

Respuestas de error

Error de autenticación (401)

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

Red inválida (400)

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

Notas

• Solo se devuelven sus propias verificaciones; no puede ver las verificaciones realizadas por otros usuarios para la misma dirección
• Las verificaciones con estado skipped (direcciones inactivas) se excluyen del historial
• Para obtener el resultado completo de cualquier verificación, use GET /apiv2/aml/{order_id} con el client_order_id