Skip to main content
O Motor de CPF/CNPJ (Motor de Análise) é a API pública para rodar análises de risco automatizadas de CNPJ e CPF — o mesmo motor usado na interface web do Sherlocker. Você envia um documento, o motor consulta as fontes de dados configuradas na sua engine e devolve um veredito consolidado com o detalhamento de cada verificação. Foi feito para quem precisa de análise cadastral e de risco dentro do próprio fluxo:
  • FIDCs — análise de cedentes e sacados antes da operação
  • Fintechs — verificação de contrapartes no onboarding
  • Backoffices de crédito — automação da esteira de cadastro
O Motor de Análise está em beta. O acesso é liberado por workspace através da feature analysis_engine (necessária para qualquer chamada /v1) e, adicionalmente, analysis_engine_pf para análises de CPF. Sem a feature, as chamadas retornam 403 feature_not_enabled. Solicite acesso aqui.

​
Como funciona

A API é assíncrona, com apenas dois endpoints:
  1. POST /analyses cria a análise com o documento (CNPJ ou CPF) e retorna 202 Accepted com o id. Os tokens do workspace são debitados nesse momento.
  2. Você faz polling com GET /analyses/{id}, respeitando o poll_after_seconds da resposta, até o status chegar a completed ou failed.
  3. No resultado, o verdict (aprovado, alerta, reprovado ou incompleto) resume a análise; blocks detalha cada verificação e coverage mostra o que foi consultado em cada fonte de dados.
Todos os endpoints usam a base https://221b-api.sherlocker.com.br/api/v1 e autenticação pelo header Authorization: Bearer slhk_sua_chave_aqui.
Os Motores usam a mesma base da API 221b (https://221b-api.sherlocker.com.br/api/v1), mas autenticam via Authorization: Bearer slhk_… — não via ?token=.
Análises que terminam em failed têm os tokens reembolsados automaticamente. A API é polling-only por enquanto: não há webhooks nem listagem de análises.

​
E o Motor de Borderô?

Este é o motor de documento individual. Se o seu caso é analisar uma operação de desconto de duplicatas a partir de um arquivo CNAB 400 — cedente, sacados e títulos de uma vez —, use o Motor de Borderô: mesma base /v1, mesma chave slhk_, mesma feature. Os dois compõem: cada título do resultado do borderô referencia análises normais desta API, consultáveis via GET /analyses/{id}. A comparação completa está em Motores de Análise.

​
Próximos passos

Quickstart

Crie sua primeira análise em minutos

Autenticação

Chaves de API, header Bearer e rastreamento de requisições

Ciclo de vida

Status, polling, verdict e o que cada campo do resultado significa