GET /apiv2/screening/providers

Penyedia yang tersedia untuk akun Anda, beserta harga, jaringan yang dicakup masing-masing penyedia, dan skala pengukuran skornya.

Ini adalah kontrak versi 2. Kontrak ini menggantikan GET /apiv2/aml/providers, yang masih tetap berfungsi.

URL Endpoint

GET https://netts.io/apiv2/screening/providers

Header Permintaan

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

Contoh Permintaan

bash

curl https://netts.io/apiv2/screening/providers \
  -H "X-API-KEY: your_api_key"

Respons

json

{
  "schema_version": 2,
  "providers": [
    {
      "provider": "elliptic",
      "price_usdt": "0.98",
      "price_trx": "2.884881",
      "available": true,
      "networks": ["ada", "algo", "apt", "arb", "atom", "avax", "base", "bch",
                   "bnb", "bsc", "btc", "celo", "cro", "doge", "dot", "dydx",
                   "etc", "eth", "fil", "flr", "ftm", "gnosis", "hbar", "hype",
                   "icp", "inj", "linea", "ltc", "matic", "mob", "near", "okb",
                   "op", "sei", "sol", "strk", "sui", "tao", "ton", "trx",
                   "xdc", "xlm", "xrp", "xtz", "zec", "zen", "zil", "zksync"],
      "score_scale": { "min": 0, "max": 10 }
    }
  ],
  "trx_rate_usd": "0.339702",
  "supported_languages": ["en"]
}

Bidang	Tipe	Deskripsi
providers[].provider	string	Nama penyedia, seperti yang dikirim dalam body pemeriksaan
providers[].price_usdt	string	Harga daftar untuk satu pemeriksaan, dalam USDT
providers[].price_trx	string \| null	Harga yang sama yang dikonversi pada nilai tukar saat ini. `null` jika nilai tukar tidak tersedia
providers[].available	boolean	Apakah pemeriksaan dapat dipesan saat ini
providers[].reason	string	Hanya ada jika `available` bernilai `false`. Saat ini `quota_exhausted`
providers[].networks	array	Simbol jaringan yang dicakup oleh penyedia ini
providers[].score_scale	object	`min` dan `max` dari skala skor milik penyedia itu sendiri
trx_rate_usd	string \| null	Nilai tukar yang digunakan untuk konversi
supported_languages	array	Bahasa laporan. Saat ini hanya `en`

Harga berupa string desimal karena alasan yang sama dengan angka-angka dalam hasil penapisan — lihat Angka adalah string. score_scale berasal dari kami dan bukan angka dari penyedia, sehingga tetap berupa angka JSON.

Untuk apa endpoint ini digunakan

Ini adalah daftar penyedia. Bidang provider pada suatu pemeriksaan merupakan string bebas dalam skema dan bukan enumerasi, justru agar penyedia baru tidak merusak sistem siapa pun yang memvalidasi respons. Konsekuensinya adalah daftar terkini berada di dalam data, bukan di dalam skema: baca di sini.

Ini juga merupakan daftar jaringan. Pasangannya penting — penyedia tidak serta-merta mencakup setiap jaringan. Memesan pemeriksaan untuk pasangan yang tidak dicakup akan mengembalikan 4004 sebelum ada biaya yang dikenakan.

Dan ini adalah asal dari skala tersebut. Skor 7 dari satu penyedia dan 0.7 dari penyedia lain bukanlah hasil pengukuran yang sama, dan tidak ada apa pun pada angka itu sendiri yang menunjukkan skala miliknya. Skala ini juga disertakan di dalam setiap hasil penapisan, di risk.scale, sehingga integrasi yang hanya membaca hasil tidak memerlukan endpoint ini sama sekali.

Penyedia yang tidak dapat digunakan oleh akun Anda tidak akan dicantumkan. BitOK dibatasi, dan akun di luar allowlist-nya tidak akan melihatnya di sini dan akan ditolak di POST /apiv2/screening dengan 4002.

Apa yang berubah dari versi 1

Versi 1 juga mengembalikan supported_formats. Bidang tersebut milik model permintaan versi 1, di mana format ditentukan saat pesanan dibuat; pada versi 2 tidak ada bidang seperti itu di dalam permintaan, karena representasi dipilih saat membaca hasil, sehingga daftar tersebut ditiadakan.

Hingga 13 September 2026 daftar tersebut mencantumkan empat format — rate, full, md, dan pdf — yang mana hanya dua yang pernah dihasilkan. Meminta pdf mengembalikan full biasa, secara diam-diam. Kedua endpoint sekarang hanya mencantumkan apa yang sebenarnya mereka kembalikan, dan versi 1 menolak md dan pdf dalam permintaan alih-alih menggantinya secara diam-diam dengan yang lain.

Markup sub-pengguna disertakan dalam price_trx, persis seperti yang disertakan dalam jumlah yang ditagihkan.

Respons Kesalahan

RFC 9457, application/problem+json.

Kode	HTTP	Kapan
`4010` / `4011`	401	Tidak ada kunci API, atau kunci atau IP tidak diterima

Batas Frekuensi

Berbagi dengan setiap jalur AML lainnya: 5 permintaan per detik, 150 per menit.

GET /apiv2/screening/providers ​

URL Endpoint ​

Header Permintaan ​

Contoh Permintaan ​

Respons ​

Untuk apa endpoint ini digunakan ​

Apa yang berubah dari versi 1 ​

Respons Kesalahan ​

Batas Frekuensi ​