Dabra MCP

Dabra - API Examples

[License: MIT] [132 consultas] [Docs]

Exemplos de integracao com a API da Dabra: 132 consultas de dados brasileiros (CNPJ, CPF, KYC, compliance, processos judiciais, credito, sancoes internacionais) e envio de SMS/OTP, por uma API REST pre-paga, com uma unica chave.

Inicio rapido

1. Crie a conta em app.dabradata.com/signup. Sem cartao de credito e sem mensalidade: voce paga por consulta, com saldo pre-pago.

2. Na pagina de chaves do painel ha duas chaves:

   • teste (dabra_test_...): aceita qualquer valor com formato valido e devolve o exemplo de resposta do endpoint, a custo zero, marcado com o header X-Example: true. A validacao de parametros e a mesma da producao. Use para montar a integracao.
   • producao (dabra_live_...): consulta real, debitada do saldo.

   Chaves emitidas antes de 24/09/2026 (fd_live_..., fd_test_...) continuam validas.

3. Rode um exemplo:

curl -H "X-API-Key: dabra_test_SUA_CHAVE" \  "https://app.dabradata.com/api/v1/consulta/receita-federal-pj?cnpj=00000000000191"

Todos os exemplos leem a chave da variavel de ambiente DABRA_API_KEY:

export DABRA_API_KEY=dabra_test_SUA_CHAVEpython python/cnpj.py 00.000.000/0001-91

Formato das chamadas

GET https://app.dabradata.com/api/v1/consulta/<slug>?<parametro>=<valor>X-API-Key: <sua chave>

• Os parametros vao na querystring (?cpf=..., ?cnpj=..., ?nome=...). CPF e CNPJ aceitam com ou sem pontuacao.
• Algumas consultas pedem "um de" (por exemplo cpf ou cnpj); a pagina de cada consulta diz quais parametros sao obrigatorios.
• As listas internacionais (OFAC, ONU, UE, Reino Unido, FBI, Interpol) sao consultadas por nome. Para pessoa fisica com CPF, listas-restritivas cruza 17 listas nacionais e internacionais pelo documento.
• Mensageria (sms-enviar, otp-send, otp-verify, otp-resend, sms-status) e mais algumas consultas usam POST com corpo JSON.
• A resposta de sucesso e o JSON da consulta, sem envelope.
• Para repetir uma chamada com seguranca, envie X-Idempotency-Key: a mesma chave devolve a resposta original sem cobrar de novo.

Referencia completa, com preco, parametros e exemplo de resposta de cada consulta: dabradata.com/docs. Toda pagina da referencia tambem existe em markdown, no mesmo endereco com .md no fim.

Exemplos por linguagem

Casos de uso

Custos de referencia pela tabela publica em 24/09/2026. O custo real de cada chamada vem no header X-Request-Cost; os precos atuais estao em dabradata.com/pricing.

Comprovante da consulta

Consultas com certidao (por exemplo tst-cndt, ccd-pj, fgts-regularidade) podem devolver o documento emitido pela fonte. Peca com comprovante=1 (na querystring, ou no corpo nas POST):

curl -s -H "X-API-Key: $DABRA_API_KEY"   "https://app.dabradata.com/api/v1/consulta/tst-cndt?cnpj=00000000000191&comprovante=1"

A resposta traz "comprovante": ["https://arquivos.dabradata.com/comprovantes/cpv_..."].

• O link e aberto (nao leva X-API-Key) e vale 7 dias.
• 202: o arquivo ainda esta sendo preparado; tente de novo em instantes (respeite Retry-After).
• 410: o prazo acabou ou o arquivo nao esta mais disponivel; faca uma nova consulta.
• Acrescimo de 25% sobre o preco da consulta, cobrado somente quando o link vem na resposta (o custo final fica em X-Request-Cost). Sem comprovante=1, nada muda.
• Com a chave de teste a resposta e o exemplo, sem custo, e o link e ficticio.

Exemplos que consultam e baixam comprovante[0], com espera no 202 e erro claro no 410: curl/comprovante.sh, python/comprovante.py, nodejs/comprovante.js, php/comprovante.php e go/comprovante.go. Documentacao: dabradata.com/docs/comprovante.

Headers de resposta

Erros

Todo erro tem o mesmo envelope:

{"error": {"code": "insufficient_balance", "message": "...", "hint": "...", "details": {}}}

Em regra, erro nao e cobrado. Algumas fontes cobram mesmo quando nao ha registro para o documento; nesses casos o custo vem em X-Request-Cost, como numa resposta de sucesso.

Saldo

curl -H "X-API-Key: $DABRA_API_KEY" https://app.dabradata.com/api/v1/administrative/balance

Resposta com cache de 60 segundos; as respostas das consultas ja trazem o saldo no header X-Balance-Remaining. Ver dabradata.com/docs/administrativo/saldo.

Webhooks

Eventos disponiveis: sms.mo.received, sms.optout e topup.credited. Cada entrega e assinada com HMAC-SHA256 do corpo bruto no header X-Dabra-Signature: sha256=<hex>. Por compatibilidade, o mesmo valor tambem e enviado em X-FonteData-Signature durante 12 meses (a partir de 24/09/2026): valide o header novo e use o legado so como fallback. Retentativas por 24 horas; deduplique por event_id. Exemplo em python/webhook_assinatura.py e documentacao em dabradata.com/docs/webhooks.

MCP

As mesmas consultas estao disponiveis para Claude, ChatGPT, Cursor e outros clientes MCP, pelo servidor remoto:

https://app.dabradata.com/mcp

Login por OAuth 2.1 no navegador, sem colar chave. O preco e o saldo sao os mesmos da API REST, e toda execucao pede confirmacao do custo antes de debitar. Ver dabradata.com/docs/mcp.

Outros produtos

• Lote: enriquecimento de uma planilha CSV inteira pelo painel, sem codigo. Formato dos arquivos: dabradata.com/docs/lote.
• Dossie: relatorio de uma pessoa ou empresa por finalidade (credito, contratacao, due diligence), com parecer e fontes citadas: dabradata.com/dossie.
• SMS e OTP: remetente white-label, OTP gerenciado e respostas do destinatario por webhook: dabradata.com/sms.

OpenAPI e Postman

• Especificacao viva: app.dabradata.com/api/v1/openapi.json
• Catalogo vivo, com precos e exemplos: app.dabradata.com/api/v1/docs
• openapi.yaml e Dabra.postman_collection.json sao snapshots gerados dessas URLs por scripts/atualizar_referencia.py. Em caso de divergencia, vale a URL viva.

No Postman, importe a colecao e preencha a variavel API_KEY. Com a chave de teste, cada requisicao devolve o exemplo do endpoint sem custo.

Links

• Documentacao: https://dabradata.com/docs
• Precos: https://dabradata.com/pricing
• Criar conta: https://app.dabradata.com/signup
• Suporte: [email protected] ou WhatsApp https://wa.me/5511991220174

Contribuindo

Veja CONTRIBUTING.md. Exemplos em novas linguagens sao bem-vindos.