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 expiradoPAYMENT_REQUIRED(402) — créditos insuficientesFORBIDDEN(403) — endpoint não liberado para o seu planoNOT_FOUND(404) — registro não encontrado