API pública B2B

Cada verificação, com sua própria API

Hoje o relatório completo já consulta 23 frentes de pessoa física e 16 de pessoa jurídica em uma única chamada. Cada uma dessas verificações também está disponível como API própria — consuma só a fonte que você precisa (ex. só situação do CPF, ou só certidões estaduais), com bilhetagem separada dos créditos de relatório.

Como funciona

Mesmo endereço, mesmo token de integração (X-Billing-Token) já usado hoje na API do relatório completo — só muda a rota. Cada fonte do catálogo tem sua própria URL, no formato abaixo:

POST /v1/fontes/{tipo_documento}/{slug} — exemplo: só a situação do CPF
curl -X POST 'https://bgc.xtrategyai.com.br/v1/fontes/cpf/situacao-cpf' \
  -H 'X-Billing-Token: bgt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "documento": "22009982878"
  }'

Fontes rápidas (a maioria) respondem na hora, com o resultado já pronto na mesma chamada. Fontes que dependem de captcha ou automação de navegador — mais lentas — seguem o mesmo padrão assíncrono do relatório completo: 202 com um identificador, e o resultado é buscado depois por polling.

Bilhetagem à parte

Créditos de API (creapies) são um saldo separado dos créditos usados para o relatório completo — consumir uma fonte avulsa nunca desconta do seu saldo de relatórios, e vice-versa. Cada fonte tem um custo fixo em creapies (tabela abaixo); o preço de cada crédito varia por volume contratado.

Catálogo e custo — 39 fontes disponíveis

Custo fixo por chamada, em creapies — independe do resultado (achou ou não achou algo). O valor em reais de cada creapie depende da faixa de volume contratada, ver tabela de preços mais abaixo.

Pessoa física (CPF) — 23 fontes

FonteCusto (creapies)Documentação
Situação do CPF
situacao-cpf
1Swagger
Processos criminais
processos-criminais
3Swagger
Processos trabalhistas
processos-trabalhistas
3Swagger
Pendências financeiras
pendencias-financeiras
4Swagger
Mandados de prisão
mandados-prisao
2Swagger
Antecedentes criminais (Polícia Federal)
antecedentes-criminais-pf
2Swagger
Pessoa politicamente exposta (PEP)
pep
1Swagger
Benefícios sociais
beneficios-sociais
1Swagger
Candidaturas eleitorais (TSE)
tse-candidaturas
1Swagger
Certidão de débitos trabalhistas (CNDT)
cndt-tst
2Swagger
Certidões estaduais
cnd-estadual
2Swagger
Conselhos de classe
conselhos-classe
1Swagger
Servidor público federal
servidor-federal
1Swagger
Servidor público estadual (SP)
servidor-estadual-sp
1Swagger
Servidor público estadual (SC)
servidor-estadual-sc
1Swagger
Mídia negativa
midia-negativa
2Swagger
CEAF
ceaf
1Swagger
Trabalho escravo
trabalho-escravo
1Swagger
Certificado de regularidade ambiental (IBAMA/CTF)
ibama-ctf-regularidade
2Swagger
TCU — contas irregulares
tcu-contas-irregulares
1Swagger
TCU — licitantes inidôneos
tcu-licitantes-inidoneos
1Swagger
TCU — inabilitados
tcu-inabilitados
1Swagger
TCU — implicação eleitoral
tcu-implicacao-eleitoral
1Swagger

Pessoa jurídica (CNPJ) — 16 fontes

FonteCusto (creapies)Documentação
Situação do CNPJ e QSA
situacao-cnpj
3Swagger
Sanções CGU (CEIS/CNEP)
cgu-sancoes
1Swagger
Certidão de regularidade do FGTS
fgts-regularidade
1Swagger
Trabalho escravo
trabalho-escravo
1Swagger
Certificado de regularidade ambiental (IBAMA/CTF)
ibama-ctf-regularidade
1Swagger
Protesto nacional
protesto-nacional
4Swagger
Processos criminais
processos-criminais
3Swagger
Processos trabalhistas
processos-trabalhistas
3Swagger
Certidão de débitos trabalhistas (CNDT)
cndt-tst
2Swagger
Certidões estaduais
cnd-estadual
2Swagger
TCU — contas irregulares
tcu-contas-irregulares
1Swagger
TCU — licitantes inidôneos
tcu-licitantes-inidoneos
1Swagger
Mapa e Street View
mapa-street-view
2Swagger
Sócios e administradores
socios-empresa
2Swagger
Situação no Simples Nacional
simples-nacional
4Swagger
Processos criminais dos sócios
socios-processos-criminais
5Swagger

Preço por crédito, por faixa de volume

Quanto mais creapies você contrata por período, mais barato fica cada um — o custo em creapies de cada fonte (tabela acima) não muda, só o valor de cada creapie em reais.

Faixa (creapies/período)Preço por crédito
0 a 2.000(franquia mínima R$ 350,00)R$ 0,1750
2.001 a 5.000R$ 0,1575
5.001 a 7.500R$ 0,1418
7.501 a 10.000R$ 0,1276
10.001 a 25.000R$ 0,1148
25.001 a 50.000R$ 0,1033
50.001 a 100.000R$ 0,0930
100.001 a 200.000R$ 0,0837
200.001 a 400.000R$ 0,0753
400.001 a 750.000R$ 0,0678
750.001 a 1.000.000R$ 0,0610
acima de 1.000.000R$ 0,0549

Perguntas frequentes

Não — são complementares. O relatório completo continua sendo a forma de due diligence pronta, com veredito e PDF autenticável. As APIs individuais servem para quem já tem seu próprio fluxo de decisão e só precisa do dado bruto de uma ou poucas fontes específicas.

Não, são dois saldos separados. Contratar uma coisa não consome o saldo da outra.

Não — o custo é fixo por chamada, independente do resultado. Uma consulta que reaproveita cache (mesmo documento consultado recentemente por outro canal) ainda debita o creapie normalmente, já que o custo cobre a chamada, não a ida à fonte externa em si.

Pode — reflete as fontes que hoje compõem o relatório completo, mesma base de dados usada em /servicos. Novas fontes que entrarem no relatório completo tendem a entrar aqui também.

Fale com nosso time de vendas — entregamos um X-Billing-Token e o saldo inicial de creapies junto com o onboarding da sua conta.