GET /apiv2/aml/history

ถูกแทนที่ด้วย GET /apiv2/screening/history

GET /apiv2/screening/history แบ่งหน้าโดยใช้ cursor แทนเลขหน้า ทำให้ข้อมูลแถวไม่เลื่อนขณะที่คุณกำลังอ่าน ตัวกรองทุกตัวเป็นแบบระบุหรือไม่ก็ได้ และรวมรายการตรวจสอบที่ถูกข้ามไว้ด้วย ส่วนปลายทางเชื่อมต่อ (endpoint) นี้ยังคงใช้งานได้ตามปกติและจะไม่มีการยกเลิกโดยไม่แจ้งล่วงหน้า

ดึงประวัติการตรวจสอบ AML สำหรับที่อยู่ที่ระบุ จะส่งกลับเฉพาะรายการตรวจสอบที่เป็นของผู้ใช้ที่ยืนยันตัวตนแล้วเท่านั้น มีการแบ่งหน้า: 100 รายการต่อหน้า เรียงจากใหม่สุดไปเก่าสุด

การประทับเวลาทั้งหมดในการตอบกลับเป็นเวลา UTC รูปแบบสตริงจะไม่มีการเปลี่ยนแปลง — "2026-09-09 23:01:44" โดยไม่มีคำต่อท้ายเขตเวลา

URL ของ Endpoint

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

Headers ของคำขอ

Header	Required	Description
X-API-KEY	Yes	API key ของคุณจากแดชบอร์ด Netts

Query พารามิเตอร์

Parameter	Type	Required	Default	Description
address	string	Yes	—	ที่อยู่บล็อกเชน (10-100 ตัวอักษร)
network	string	Yes	—	ตัวย่อเครือข่ายบล็อกเชน (ดู Supported Networks)
page	integer	No	1	หมายเลขหน้า (เริ่มต้นที่ 1, 100 รายการต่อหน้า)

Examples การร้องขอ

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 (ที่อยู่ที่ไม่มีความเคลื่อนไหว) จะไม่รวมอยู่ในประวัติ
• หากต้องการดูผลลัพธ์แบบเต็มของการตรวจสอบใดๆ ให้ใช้ GET /apiv2/aml/{order_id} พร้อมกับ client_order_id