GET /apiv2/screening/providers

Провайдери, доступні для вашого акаунта, з цінами, мережами, які покриває кожен із них, та шкалою, за якою вимірюється їхній бал.

Це контракт версії 2. Він замінює GET /apiv2/aml/providers, який продовжує працювати.

URL кінцевої точки

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

Заголовки запиту

Заголовок	Обов'язковий	Опис
X-API-KEY	Так	Ваш API-ключ із панелі керування Netts

Приклад запиту

bash

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

Відповідь

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

Поле	Тип	Опис
providers[].provider	рядок	Назва провайдера, як вона передається в тілі перевірки
providers[].price_usdt	рядок	Прейскурантна ціна однієї перевірки в USDT
providers[].price_trx	рядок \| null	Та сама ціна, конвертована за поточним курсом. `null`, коли курс недоступний
providers[].available	логічний	Чи можна замовляти перевірки прямо зараз
providers[].reason	рядок	Присутнє лише тоді, коли `available` має значення `false`. Наразі `quota_exhausted`
providers[].networks	масив	Тікери мереж, які покриває цей провайдер
providers[].score_scale	об'єкт	`min` та `max` власної шкали балів провайдера
trx_rate_usd	рядок \| null	Курс, використаний для конвертації
supported_languages	масив	Мови звітів. Наразі лише `en`

Ціни є десятковими рядками з тієї ж причини, що й числа в результатах скринінгу — див. Числа є рядками. Поле score_scale є нашим значенням, а не показником провайдера, тому воно залишається числом JSON.

Для чого призначений цей ендпоінт

Це список провайдерів. Поле provider перевірки є довільним рядком у схемі, а не переліком, саме для того, щоб новий провайдер не порушував роботу тих, хто валідує відповіді. Як наслідок, поточний список міститься в даних, а не в схемі: зчитуйте його тут.

Це також список мереж. Поєднання має значення — провайдер не обов'язково покриває кожну мережу. Замовлення перевірки для пари, яка не покривається, повертає 4004 до списання будь-яких коштів.

І звідси береться шкала. Оцінка 7 від одного провайдера та 0.7 від іншого — це не однаковий показник, і саме по собі число не вказує, до якої шкали воно належить. Шкала також надходить у кожному результаті скринінгу в risk.scale, тому інтеграція, яка лише зчитує результати, взагалі не потребує цього ендпоінта.

Провайдер, якого ваш акаунт не може використовувати, відсутній у списку. BitOK має обмежений доступ, і акаунти поза його списком дозволених не бачать його тут та отримують відмову на POST /apiv2/screening із кодом 4002.

Що змінилося порівняно з версією 1

Версія 1 також повертає supported_formats. Це поле належить до моделі запиту версії 1, де формат фіксувався під час створення замовлення; у версії 2 такого поля в запиті немає, оскільки представлення обирається під час зчитування результату, тому цей список прибрано.

До 13 вересня 2026 року в цьому списку вказувалися чотири формати — rate, full, md та pdf — з яких коли-небудь генерувалися лише два. Запит pdf повертав звичайний full, без жодних попереджень. Тепер обидва ендпоінти вказують лише те, що вони насправді повертають, а версія 1 відхиляє md та pdf у запиті замість непомітної підміни на щось інше.

Націнка субкористувача включена в price_trx так само, як вона включена в суму списання.

Помилки

RFC 9457, application/problem+json.

Код	HTTP	Коли
`4010` / `4011`	401	Відсутній API-ключ, або ключ чи IP-адресу не прийнято

Ліміти частоти запитів

Спільні з будь-яким іншим шляхом AML: 5 запитів на секунду, 150 на хвилину.

GET /apiv2/screening/providers ​

URL кінцевої точки ​

Заголовки запиту ​

Приклад запиту ​

Відповідь ​

Для чого призначений цей ендпоінт ​

Що змінилося порівняно з версією 1 ​

Помилки ​

Ліміти частоти запитів ​