Documentação da API

A API DadosBR entrega dados públicos brasileiros em JSON, com um padrão de resposta consistente.

Autenticação

Toda requisição exige um token no cabeçalho Authorization:

Authorization: Bearer SEU_TOKEN

Gere tokens no seu painel. O token é exibido apenas uma vez na criação.

URL base

https://api.dados.br/v1

Padrão de resposta

Sucesso

{
  "success": true,
  "data": { },
  "meta": {
    "credits_used": 1,
    "credits_remaining": 99,
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Erro

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "CNPJ não encontrado na base de dados."
  }
}

Códigos de erro

  • UNAUTHORIZED (401) — token ausente, inválido ou expirado
  • PAYMENT_REQUIRED (402) — créditos insuficientes
  • FORBIDDEN (403) — endpoint não liberado para o seu plano
  • NOT_FOUND (404) — registro não encontrado

Endpoints