GET /apiv2/aml/history

کسی مخصوص ایڈریس کے لیے AML چیک کی ہسٹری حاصل کریں۔ صرف تصدیق شدہ صارف سے متعلق چیکس واپس کرتا ہے۔ صفحہ بندی (Paginated): 100 آئٹمز فی صفحہ، تازہ ترین پہلے۔

اینڈپوائنٹ URL

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

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

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

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

پیرامیٹر	قسم	لازمی	طے شدہ	تفصیل
address	string	ہاں	—	بلاک چین ایڈریس (10-100 کریکٹرز)
network	string	ہاں	—	بلاک چین نیٹ ورک ٹکر (ملاحظہ کریں معاونت یافتہ نیٹ ورکس)
page	integer	نہیں	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	string	طلب کردہ ایڈریس
data.total	integer	اس ایڈریس کے لیے چیکس کی کل تعداد
data.page	integer	موجودہ صفحہ نمبر
data.pages	integer	کل صفحات کی تعداد
data.checks	array	چیک ریکارڈز کی صف (فی صفحہ زیادہ سے زیادہ 100)

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

فیلڈ	قسم	تفصیل
client_order_id	string	آرڈر ID — مکمل نتائج کے لیے 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 اگر پابندیوں کی زد میں آنا پایا گیا ہو

صفحہ بندی (Pagination)

• ہر صفحہ تاریخ کے لحاظ سے ترتیب شدہ (تازہ ترین پہلے) زیادہ سے زیادہ 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} کا استعمال کریں