GET /apiv2/aml/history

Digantikan oleh GET /apiv2/screening/history

GET /apiv2/screening/history melakukan paginasi berdasarkan kursor alih-alih nomor halaman, sehingga data tidak bergeser saat Anda membaca; setiap filter bersifat opsional, dan pemeriksaan yang dilewati turut disertakan. Endpoint ini tetap berfungsi dan tidak akan dihentikan tanpa pemberitahuan.

Dapatkan riwayat pemeriksaan AML untuk alamat tertentu. Hanya mengembalikan pemeriksaan milik pengguna yang terautentikasi. Menggunakan paginasi: 100 item per halaman, yang terbaru ditampilkan terlebih dahulu.

Semua stempel waktu dalam respons menggunakan UTC. Format string tidak berubah — "2026-09-09 23:01:44", tanpa sufiks zona.

URL Endpoint

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

Header Permintaan

Header	Wajib	Deskripsi
X-API-KEY	Ya	Kunci API Anda dari dasbor Netts

Parameter Kueri

Parameter	Tipe	Wajib	Standar	Deskripsi
address	string	Ya	—	Alamat blockchain (10-100 karakter)
network	string	Ya	—	Ticker jaringan blockchain (lihat Supported Networks)
page	integer	Tidak	1	Nomor halaman (berbasis 1, 100 item per halaman)

Contoh

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']})")

Respons

Berhasil (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"
}

Tidak Ada Hasil (200 OK)

{
    "success": true,
    "data": {
        "address": "TXtARC75jmh7sDDfHFunLbpA44T7JhJ53u",
        "total": 0,
        "page": 1,
        "pages": 0,
        "checks": []
    },
    "timestamp": "2026-03-10 15:05:00"
}

Bidang Respons

Bidang	Tipe	Deskripsi
data.address	string	Alamat yang diminta
data.total	integer	Jumlah total pemeriksaan untuk alamat ini
data.page	integer	Nomor halaman saat ini
data.pages	integer	Jumlah total halaman
data.checks	array	Array data riwayat pemeriksaan (hingga 100 per halaman)

Bidang Data Pemeriksaan

Bidang	Tipe	Deskripsi
client_order_id	string	ID pesanan — gunakan dengan GET /apiv2/aml/{order_id} untuk hasil lengkap
provider	string	Penyedia AML: elliptic
status	string	completed, pending, processing, failed
created_at	string	Tanggal/waktu pengajuan pemeriksaan
completed_at	string | null	Tanggal/waktu penyelesaian pemeriksaan
risk_score	number | null	Skor risiko (Elliptic: 0-10). null jika belum selesai
risk_level	string | null	low, medium, atau high
is_sanctioned	boolean | null	true jika terdeteksi paparan sanksi

Paginasi

• Setiap halaman mengembalikan hingga 100 data, diurutkan berdasarkan tanggal (terbaru lebih dahulu)
• Gunakan total untuk mengetahui berapa banyak pemeriksaan yang ada untuk alamat ini
• Gunakan pages untuk mengetahui nomor halaman terakhir yang tersedia
• page=1 mengembalikan 100 pemeriksaan terbaru, page=2 mengembalikan 100 pemeriksaan berikutnya, dll.

Respons Kesalahan

Kesalahan Autentikasi (401)

{
    "detail": {
        "code": -1,
        "msg": "API key not provided"
    }
}

Jaringan Tidak Valid (400)

{
    "success": false,
    "error": {
        "code": 4002,
        "message": "Unsupported network: xyz. See supported networks list."
    }
}

Catatan

• Hanya pemeriksaan milik Anda yang dikembalikan — Anda tidak dapat melihat pemeriksaan yang dilakukan oleh pengguna lain untuk alamat yang sama
• Pemeriksaan berstatus skipped (alamat tidak aktif) dikecualikan dari riwayat
• Untuk mendapatkan hasil lengkap dari pemeriksaan apa pun, gunakan GET /apiv2/aml/{order_id} bersama dengan client_order_id