GET /apiv2/screening/providers
Proveedores disponibles para su cuenta, con precios, las redes que cubre cada uno y la escala en la que se mide su puntuación.
Este es el contrato de la versión 2. Reemplaza a GET /apiv2/aml/providers, que sigue funcionando.
URL del endpoint
GET https://netts.io/apiv2/screening/providersEncabezados de solicitud
| Header | Required | Description |
|---|---|---|
| X-API-KEY | Sí | Su clave API del panel de Netts |
Ejemplo de solicitud
curl https://netts.io/apiv2/screening/providers \
-H "X-API-KEY: your_api_key"Respuesta
{
"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"]
}| Field | Type | Description |
|---|---|---|
| providers[].provider | string | Nombre del proveedor, tal como se envía en el cuerpo de una verificación |
| providers[].price_usdt | string | Precio de lista de una verificación, en USDT |
| providers[].price_trx | string | null | El mismo precio convertido a la tasa actual. null cuando la tasa no está disponible |
| providers[].available | boolean | Si se pueden solicitar verificaciones en este momento |
| providers[].reason | string | Presente solo cuando available es false. Actualmente quota_exhausted |
| providers[].networks | array | Tickers de red que cubre este proveedor |
| providers[].score_scale | object | min y max de la propia escala de puntuación del proveedor |
| trx_rate_usd | string | null | Tasa utilizada para la conversión |
| supported_languages | array | Idiomas de los informes. Actualmente solo en |
Los precios son cadenas decimales por la misma razón que lo son los números en un resultado de screening — consulte Numbers are strings. score_scale es una cifra nuestra en lugar de la del proveedor, por lo que permanece como un número JSON.
Para qué sirve este endpoint
Es la lista de proveedores. El campo provider de una verificación es una cadena de texto libre en el esquema en lugar de una enumeración, precisamente para que un nuevo proveedor no rompa la integración de nadie que valide respuestas. La consecuencia es que la lista actual reside en los datos, no en el esquema: consúltela aquí.
También es la lista de redes. El emparejamiento importa — un proveedor no cubre necesariamente todas las redes. Solicitar una verificación para un par que no está cubierto devuelve 4004 antes de que se realice ningún cargo.
Y es de donde proviene la escala. Una puntuación de 7 de un proveedor y 0.7 de otro no son la misma lectura, y nada en el número en sí indica a qué escala pertenece. La escala también se incluye dentro de cada resultado de screening, en risk.scale, por lo que una integración que solo lee resultados no necesita este endpoint en absoluto.
Un proveedor que su cuenta no puede usar no aparece en la lista. BitOK está restringido, y las cuentas que no están en su lista de permitidos no lo ven aquí y son rechazadas en POST /apiv2/screening con 4002.
Qué cambió respecto a la versión 1
La versión 1 también devuelve supported_formats. Ese campo pertenece al modelo de solicitud de la versión 1, donde el formato se fijaba al crear la orden; en la versión 2 no existe tal campo en la solicitud, ya que la representación se elige al leer el resultado, por lo que la lista ya no está.
Hasta el 13 de septiembre de 2026 esa lista mencionaba cuatro formatos — rate, full, md y pdf — de los cuales solo dos llegaron a generarse. Solicitar pdf devolvía full ordinario, de forma silenciosa. Ambos endpoints ahora mencionan únicamente lo que realmente devuelven, y la versión 1 rechaza md y pdf en una solicitud en lugar de sustituir discretamente otra cosa.
El margen de subusuario está incluido en price_trx, exactamente igual que se incluye en el monto cobrado.
Respuestas de error
RFC 9457, application/problem+json.
| Code | HTTP | When |
|---|---|---|
4010 / 4011 | 401 | Sin clave API, o una clave o IP no aceptada |
Límites de tasa
Compartidos con todas las demás rutas de AML: 5 solicitudes por segundo, 150 por minuto.