GET /apiv2/aml/

Được thay thế bởi GET /apiv2/screening/

GET /apiv2/screening/{client_order_id} là hợp đồng phiên bản 2. Endpoint này vẫn tiếp tục hoạt động và sẽ không bị ngừng mà không có thông báo trước.

Lấy trạng thái và kết quả của một yêu cầu kiểm tra AML đã gửi trước đó.

Tất cả dấu thời gian trong phản hồi đều là UTC. Định dạng chuỗi không thay đổi — "2026-09-09 23:01:44", không có hậu tố múi giờ.

URL Endpoint

GET https://netts.io/apiv2/aml/{order_id}

Headers của yêu cầu

Header	Bắt buộc	Mô tả
X-API-KEY	Có	Khóa API của bạn từ bảng điều khiển Netts

Tham số đường dẫn

Tham số	Loại	Bắt buộc	Mô tả
order_id	chuỗi	Có	ID đơn hàng được trả về từ POST /apiv2/aml

Examples Yêu cầu

cURL

curl -X GET https://netts.io/apiv2/aml/A4C666ABE24BD4A \
  -H "X-API-KEY: your_api_key" \

Python

import requests

order_id = "A4C666ABE24BD4A"
headers = {
    "X-API-KEY": "your_api_key",
}

response = requests.get(f"https://netts.io/apiv2/aml/{order_id}", headers=headers)
data = response.json()

result = data.get("data", {})
print(f"Status: {result.get('status')}")
print(f"Risk Score: {result.get('risk_score')}")
print(f"Risk Level: {result.get('risk_level')}")

Phản hồi

Kiểm tra hoàn tất (200 OK)

{
    "success": true,
    "data": {
        "client_order_id": "A4C666ABE24BD4A",
        "status": "completed",
        "address": "TXtARC75jmh7sDDfHFunLbpA44T7JhJ53u",
        "provider": "elliptic",
        "report_language": "en",
        "risk_score": 10.0,
        "risk_level": "high",
        "is_sanctioned": false,
        "created_at": "2026-03-10 09:56:31",
        "completed_at": "2026-03-10 09:56:32",
        "result": {
            "risk_score": 10,
            "cluster_entities": [
                {
                    "name": "ChangeHero",
                    "category": "Coin Swap Service"
                }
            ]
        },
        "sanctions": {
            "self": false,
            "self_entities": null,
            "exposure": null,
            "items": []
        }
    },
    "timestamp": "2026-03-10 10:00:00"
}

Đối tượng sanctions phân biệt giữa một địa chỉ bị trừng phạt và một địa chỉ chỉ đơn thuần liên kết với một thực thể bị trừng phạt. Các trường của đối tượng này được mô tả trên trang kiểm tra.

Kiểm tra đang chờ xử lý (200 OK)

{
    "success": true,
    "data": {
        "client_order_id": "A4C666ABE24BD4A",
        "status": "pending",
        "address": "TPCHni9H51NEr8iT6fNJgkdMUBPbF79HBV",
        "provider": "elliptic",
        "report_language": "en",
        "message": "AML check is being processed",
        "estimated_time_seconds": 5,
        "created_at": "2026-03-10 09:56:31"
    },
    "timestamp": "2026-03-10 09:56:35"
}

Không tìm thấy đơn hàng (404)

{
    "success": false,
    "error": {
        "code": 4040,
        "message": "Order not found"
    },
    "timestamp": "2026-03-10 10:00:00"
}

Ghi chú

• Thăm dò (poll) endpoint này để nhận kết quả cho các yêu cầu kiểm tra bất đồng bộ (được gửi mà không có wait: true)
• Thời gian hoàn thành kiểm tra thông thường: 2-10 giây
• Việc thăm dò không làm phát sinh thêm chi phí