Skip to content
This translation is behind the English original, updated 2026-09-15. Read the English version for the current text.

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/providers

Encabezados de solicitud

HeaderRequiredDescription
X-API-KEYSu clave API del panel de Netts

Ejemplo de solicitud

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

Respuesta

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"]
}
FieldTypeDescription
providers[].providerstringNombre del proveedor, tal como se envía en el cuerpo de una verificación
providers[].price_usdtstringPrecio de lista de una verificación, en USDT
providers[].price_trxstring | nullEl mismo precio convertido a la tasa actual. null cuando la tasa no está disponible
providers[].availablebooleanSi se pueden solicitar verificaciones en este momento
providers[].reasonstringPresente solo cuando available es false. Actualmente quota_exhausted
providers[].networksarrayTickers de red que cubre este proveedor
providers[].score_scaleobjectmin y max de la propia escala de puntuación del proveedor
trx_rate_usdstring | nullTasa utilizada para la conversión
supported_languagesarrayIdiomas 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.

CodeHTTPWhen
4010 / 4011401Sin 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.