GET /apiv2/aml/history

Substituído por GET /apiv2/screening/history

GET /apiv2/screening/history pagina por cursor em vez de número de página, de modo que os registros não mudam de posição enquanto você lê; todos os filtros são opcionais e as verificações ignoradas são incluídas. Este endpoint continua funcionando e não será descontinuado sem aviso prévio.

Obtém o histórico de verificações AML para um endereço específico. Retorna apenas verificações pertencentes ao usuário autenticado. Paginado: 100 itens por página, mais recentes primeiro.

Todos os carimbos de data/hora na resposta estão em UTC. O formato da string permanece inalterado — "2026-09-09 23:01:44", sem sufixo de fuso horário.

URL do endpoint

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

Cabeçalhos da requisição

Header	Required	Description
X-API-KEY	Sim	Sua chave de API do painel da Netts

Parâmetros de consulta

Parameter	Type	Required	Default	Description
address	string	Sim	—	Endereço blockchain (10 a 100 caracteres)
network	string	Sim	—	Ticker da rede blockchain (consulte Redes Suportadas)
page	integer	Não	1	Número da página (base 1, 100 itens por página)

Examples de Requisição

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

Resposta

Sucesso (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"
}

Sem Resultados (200 OK)

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

Campos da Resposta

Field	Type	Description
data.address	string	Endereço consultado
data.total	integer	Número total de verificações para este endereço
data.page	integer	Número da página atual
data.pages	integer	Número total de páginas
data.checks	array	Array de registros de verificação (até 100 por página)

Campos do Registro de Verificação

Field	Type	Description
client_order_id	string	ID do pedido — use com GET /apiv2/aml/{order_id} para obter o resultado completo
provider	string	Provedor AML: elliptic
status	string	completed, pending, processing, failed
created_at	string	Data/hora de envio da verificação
completed_at	string | null	Data/hora de conclusão da verificação
risk_score	number | null	Pontuação de risco (Elliptic: 0-10). null se não concluído
risk_level	string | null	low, medium ou high
is_sanctioned	boolean | null	true se exposição a sanções for detectada

Paginação

• Cada página retorna até 100 registros, ordenados por data (mais recentes primeiro)
• Use total para saber quantas verificações existem para este endereço
• Use pages para saber o número da última página disponível
• page=1 retorna as 100 verificações mais recentes, page=2 as próximas 100, etc.

Respostas de erro

Erro de Autenticação (401)

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

Rede Inválida (400)

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

Notas

• Apenas as suas próprias verificações são retornadas — você não pode ver verificações feitas por outros usuários para o mesmo endereço
• Verificações com status skipped (endereços inativos) são excluídas do histórico
• Para obter o resultado completo de qualquer verificação, use GET /apiv2/aml/{order_id} com o client_order_id