GET /apiv2/screening/providers

Provedores disponíveis para a sua conta, com preços, as redes que cada um cobre e a escala na qual sua pontuação é medida.

Este é o contrato da versão 2. Ele substitui GET /apiv2/aml/providers, que continua funcionando.

URL do endpoint

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

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
X-API-KEY	Sim	Sua chave de API do painel da Netts

Exemplo de Requisição

bash

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

Resposta

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

Campo	Tipo	Descrição
providers[].provider	string	Nome do provedor, conforme enviado no corpo de uma verificação
providers[].price_usdt	string	Preço de tabela de uma verificação, em USDT
providers[].price_trx	string \| null	O mesmo preço convertido na taxa atual. `null` quando a taxa estiver indisponível
providers[].available	boolean	Se as verificações podem ser solicitadas no momento
providers[].reason	string	Presente apenas quando `available` for `false`. Atualmente `quota_exhausted`
providers[].networks	array	Tickers de rede que este provedor cobre
providers[].score_scale	object	`min` e `max` da própria escala de pontuação do provedor
trx_rate_usd	string \| null	Taxa utilizada para a conversão
supported_languages	array	Idiomas do relatório. Atualmente apenas `en`

Os preços são strings decimais pelo mesmo motivo que os números no resultado de uma triagem são — consulte Números são strings. score_scale é um valor nosso e não do provedor, portanto permanece como um número JSON.

Para que serve este endpoint

É a lista de provedores. O campo provider de uma verificação é uma string de formato livre no esquema, em vez de uma enumeração, justamente para que um novo provedor não quebre integrações de quem valida respostas. A consequência é que a lista atual reside nos dados, não no esquema: leia-a aqui.

É também a lista de redes. A combinação é importante — um provedor não cobre necessariamente todas as redes. Solicitar uma verificação para um par que não é coberto retorna 4004 antes que qualquer cobrança seja feita.

E é de onde vem a escala. Uma pontuação de 7 de um provedor e 0.7 de outro não são a mesma leitura, e nada no próprio número indica a qual escala ele pertence. A escala também é fornecida dentro de cada resultado de triagem, em risk.scale, portanto uma integração que apenas lê resultados não precisa deste endpoint de forma alguma.

Um provedor que sua conta não pode usar não é listado. O BitOK é restrito, e contas fora de sua lista de permissões não o visualizam aqui e são recusadas em POST /apiv2/screening com 4002.

O que mudou em relação à versão 1

A versão 1 também retorna supported_formats. Esse campo pertence ao modelo de requisição da versão 1, onde o formato era fixado no momento em que o pedido era criado; na versão 2 não existe tal campo na requisição, pois a representação é escolhida ao ler o resultado, portanto a lista foi removida.

Até 13 de setembro de 2026, essa lista indicava quatro formatos — rate, full, md e pdf — dos quais apenas dois chegaram a ser produzidos. Solicitar pdf retornava o full comum, silenciosamente. Ambos os endpoints agora indicam apenas o que realmente retornam, e a versão 1 recusa md e pdf em uma requisição em vez de substituir discretamente por outra coisa.

A margem de lucro de subusuários está incluída em price_trx, exatamente como está incluída no valor cobrado.

Erros

RFC 9457, application/problem+json.

Código	HTTP	Quando
`4010` / `4011`	401	Nenhuma chave de API fornecida, ou chave ou IP não aceito

Limites de taxa

Compartilhado com todas as outras rotas de AML: 5 requisições por segundo, 150 por minuto.

GET /apiv2/screening/providers ​

URL do endpoint ​

Cabeçalhos da requisição ​

Exemplo de Requisição ​

Resposta ​

Para que serve este endpoint ​

O que mudou em relação à versão 1 ​

Erros ​

Limites de taxa ​