Documentação da API

Referência rápida de integração. A API usa HTTPS, responde em JSON (UTF-8) e é compatível com o formato de pacotes do mercado — se você já integra com outro fornecedor, basta trocar a URL base e o token.

URL base

Todas as requisições devem ser feitas para:

https://api.radardata.com.br

Em ambiente de testes (sandbox), utilize o mesmo endereço — serviços marcados como sandbox não consomem saldo.

Formato da consulta

Uma única rota GET resolve todas as consultas, no formato compatível:

GET /{token}/{pacote}/{documento}

token — token de API gerado em Painel → Tokens de API.
pacote — número inteiro que identifica o serviço (veja a coluna "Pacote" na tabela de preços).
documento — CPF (11 dígitos) ou CNPJ (14 dígitos), somente números. Para serviços de veículo, a placa.

Exemplo — pacote 6 (CNPJ completo)

GET https://api.radardata.com.br/{seu_token}/6/00000000000191

Resposta

{
  "status": 1,
  "pacote": 6,
  "documento": "00000000000191",
  "dados": {
    "cnpj": "00.000.000/0001-91",
    "razao_social": "BANCO DO BRASIL SA",
    "nome_fantasia": "BANCO DO BRASIL",
    "situacao_cadastral": "ATIVA",
    "data_abertura": "1966-08-01",
    "natureza_juridica": "2038-3 - Sociedade de Economia Mista",
    "capital_social": 120000000000,
    "endereco": {
      "logradouro": "SAUN QUADRA 5 LOTE B",
      "municipio": "BRASILIA",
      "uf": "DF",
      "cep": "70040-912"
    },
    "cnae_principal": {
      "codigo": "6421-2/00",
      "descricao": "Bancos comerciais"
    },
    "socios": [
      { "nome": "UNIAO FEDERAL", "qualificacao": "Acionista" }
    ]
  },
  "cache": false,
  "tempo_ms": 312
}

O campo status: 1 indica sucesso. Em erros, status: 0 acompanha um codigo da tabela abaixo. Consultas com "cache": true foram atendidas pela camada de cache e podem ter preço reduzido.

Consulta de saldo

Para consultar o saldo da conta programaticamente:

GET https://api.radardata.com.br/{seu_token}/saldo

{
  "status": 1,
  "saldo": 1250075,
  "saldo_formatado": "R$ 12.500,75",
  "modo_cobranca": "PRE"
}

O campo saldo é um inteiro em centavos. A consulta de saldo é gratuita e não conta para o limite de requisições.

Códigos de erro

Erros retornam HTTP 200 com status: 0 e um dos códigos abaixo no corpo — comportamento compatível com integrações legadas.

Código	Significado	O que fazer
`100`	Token ausente ou mal formatado	Verifique se o token foi incluído na URL exatamente como gerado no painel.
`101`	Token inválido ou revogado	Gere um novo token em Painel → Tokens de API.
`102`	Conta suspensa ou bloqueada	Entre em contato com o suporte para regularizar a conta.
`200`	Saldo insuficiente	Adicione saldo no painel antes de repetir a consulta.
`201`	Limite pós-pago excedido	Aguarde o fechamento da fatura ou solicite aumento de limite.
`202`	Serviço indisponível para o seu plano	Confira a tabela de preços ou fale com o time comercial.
`400`	Requisição inválida	Revise o número do pacote e o formato da URL.
`1000`	Documento inválido	Envie um CPF (11 dígitos) ou CNPJ (14 dígitos) válido, apenas números.
`1001`	Documento não encontrado na base	O documento é válido, mas não há registro na fonte consultada.
`1002`	Pacote inexistente	Confira o número do pacote na tabela de preços.
`1003`	Pacote em manutenção	Tente novamente em alguns minutos.
`1004`	Fonte de dados indisponível	Falha temporária no provedor. Consultas com erro não são cobradas.
`1005`	Tempo de resposta excedido (timeout)	Repita a consulta; considere aumentar o timeout do seu cliente para 60s.
`1006`	Limite de requisições por minuto excedido	Reduza a taxa de envio ou distribua as consultas ao longo do tempo.
`1007`	Consulta bloqueada por política de uso	Documento ou padrão de uso sinalizado. Contate o suporte.

Boas práticas

Configure timeout de pelo menos 60 segundos no seu cliente HTTP.
Consultas com erro de fonte (códigos 1004/1005) não são cobradas — é seguro repetir.
Use tokens diferentes por sistema/ambiente e revogue imediatamente tokens expostos.
Valide o documento localmente (dígitos verificadores) antes de enviar para evitar o custo de consultas inválidas.
Teste qualquer pacote sem escrever código pelo playground do painel.