GET /apiv2/aml/history

GET /apiv2/screening/history ile değiştirildi

GET /apiv2/screening/history, sayfa numarası yerine imleç (cursor) ile sayfalandırma yapar, böylece siz okurken kayıtlar kaymaz; tüm filtreler isteğe bağlıdır ve atlanan kontroller dahil edilir. Bu uç nokta çalışmaya devam etmektedir ve önceden bildirilmeksizin kaldırılmayacaktır.

Belirli bir adres için AML kontrol geçmişini alın. Yalnızca kimliği doğrulanmış kullanıcıya ait kontrolleri döndürür. Sayfalandırılmış: sayfa başına 100 öge, en yeniden en eskiye.

Yanıttaki tüm zaman damgaları UTC formatındadır. Dize formatı değişmez — "2026-09-09 23:01:44", saat dilimi son eki olmadan.

Uç Nokta URL'si

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

İstek Başlıkları

Başlık	Zorunlu	Açıklama
X-API-KEY	Evet	Netts kontrol panelinden alınan API anahtarınız

Sorgu Parametreleri

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
address	string	Evet	—	Blokzincir adresi (10-100 karakter)
network	string	Evet	—	Blokzincir ağı kısaltması (bkz. Desteklenen Ağlar)
page	integer	Hayır	1	Sayfa numarası (1 tabanlı, sayfa başına 100 öge)

Örnek İstekler

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

Yanıt

Başarılı (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"
}

Sonuç Yok (200 OK)

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

Yanıt Alanları

Alan	Tür	Açıklama
data.address	string	Sorgulanan adres
data.total	integer	Bu adres için toplam kontrol sayısı
data.page	integer	Geçerli sayfa numarası
data.pages	integer	Toplam sayfa sayısı
data.checks	array	Kontrol kayıtları dizisi (sayfa başına en fazla 100)

Kontrol Kaydı Alanları

Alan	Tür	Açıklama
client_order_id	string	Sipariş Kimliği — tam sonuç için GET /apiv2/aml/{order_id} ile kullanın
provider	string	AML sağlayıcısı: elliptic
status	string	completed, pending, processing, failed
created_at	string	Kontrol gönderim tarihi/saati
completed_at	string | null	Kontrol tamamlanma tarihi/saati
risk_score	number | null	Risk puanı (Elliptic: 0-10). Tamamlanmadıysa null
risk_level	string | null	low, medium veya high
is_sanctioned	boolean | null	Yaptırım riski tespit edildiyse true

Sayfalandırma

• Her sayfa tarihe göre sıralanmış (en yeniden en eskiye) en fazla 100 kayıt döndürür
• Bu adres için kaç adet kontrolün mevcut olduğunu öğrenmek için total alanını kullanın
• Kullanılabilir son sayfa numarasını öğrenmek için pages alanını kullanın
• page=1 en son 100 kontrolü, page=2 sonraki 100 kontrolü döndürür, vb.

Hata Yanıtları

Kimlik Doğrulama Hatası (401)

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

Geçersiz Ağ (400)

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

Notlar

• Yalnızca kendi kontrolleriniz döndürülür — aynı adres için diğer kullanıcılar tarafından yapılan kontrolleri göremezsiniz
• skipped durumundaki kontroller (aktif olmayan adresler) geçmişten hariç tutulur
• Herhangi bir kontrolün tam sonucunu almak için client_order_id ile birlikte GET /apiv2/aml/{order_id} uç noktasını kullanın