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

درخواست کے ہیڈرز

ہیڈر	ضروری ہے	تفصیل
X-API-KEY	ہاں	Netts ڈیش بورڈ سے آپ کی API کلید

کوئری پیرامیٹرز

پیرامیٹر	قسم	ضروری ہے	ڈیفالٹ	تفصیل
address	سٹرنگ	ہاں	—	بلاک چین ایڈریس (10-100 کریکٹرز)
network	سٹرنگ	ہاں	—	بلاک چین نیٹ ورک ٹکر (تعاون یافتہ نیٹ ورکس دیکھیں)
page	انٹیجر	نہیں	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"
}

جواب کے فیلڈز

فیلڈ	قسم	تفصیل
data.address	سٹرنگ	تلاش کیا گیا ایڈریس
data.total	انٹیجر	اس ایڈریس کے لیے چیکس کی کل تعداد
data.page	انٹیجر	موجودہ صفحہ نمبر
data.pages	انٹیجر	صفحات کی کل تعداد
data.checks	ارے	چیک ریکارڈز کی فہرست (فی صفحہ 100 تک)

چیک ریکارڈ کے فیلڈز

فیلڈ	قسم	تفصیل
client_order_id	سٹرنگ	آرڈر ID — مکمل نتائج کے لیے GET /apiv2/aml/{order_id} کے ساتھ استعمال کریں
provider	سٹرنگ	AML فراہم کنندہ: elliptic
status	سٹرنگ	completed، pending، processing، failed
created_at	سٹرنگ	چیک جمع کرانے کی تاریخ/وقت
completed_at	سٹرنگ | null	چیک مکمل ہونے کی تاریخ/وقت
risk_score	نمبر | null	رسک اسکور (Elliptic: 0-10)۔ اگر مکمل نہ ہوا ہو تو null
risk_level	سٹرنگ | null	low، medium، یا high
is_sanctioned	بولین | 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} کا استعمال کریں