Dabra - API Examples

Exemplos de integracao com a API da Dabra: 133 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_CHAVE
python 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.

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: contato@dabradata.com ou WhatsApp https://wa.me/5511991220174

Contribuindo

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