GET /apiv2/aml/history

GET /apiv2/screening/history द्वारा प्रतिस्थापित

GET /apiv2/screening/history पृष्ठ संख्या के बजाय कर्सर द्वारा पेजिनेट करता है, जिससे आपके पढ़ने के दौरान रिकॉर्ड्स बदलते नहीं हैं; प्रत्येक फ़िल्टर वैकल्पिक है, और छोड़े गए (skipped) चेक्स शामिल हैं। यह एंडपॉइंट काम करता रहेगा और बिना सूचना के वापस नहीं लिया जाएगा।

किसी विशिष्ट पते के लिए 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	Yes	Netts डैशबोर्ड से आपकी API कुंजी

क्वेरी पैरामीटर

Parameter	Type	Required	Default	Description
address	string	Yes	—	ब्लॉकचेन पता (10-100 वर्ण)
network	string	Yes	—	ब्लॉकचेन नेटवर्क टिकर (समर्थित नेटवर्क देखें)
page	integer	No	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	ऑर्डर आईडी — पूर्ण परिणाम के लिए 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 स्थिति वाले चेक्स (निष्क्रिय पते) इतिहास से बाहर रखे गए हैं
• किसी भी चेक का पूरा परिणाम प्राप्त करने के लिए, client_order_id के साथ GET /apiv2/aml/{order_id} का उपयोग करें