API Documentation

Integre dados empresariais no seu sistema em minutos.

Autenticacao

Todas as requisicoes exigem um API key no header Authorization:

curl -H "Authorization: Bearer vd_live_abc123..." \
https://api.veridata.com.br/v1/empresas/33000167000101

Rate Limits

Plano	Req/minuto	Req/mes
Gratuito	10	100
Profissional	60	5.000
Enterprise	300	Ilimitado

Headers de rate limit: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Endpoints

GET/v1/search

Buscar empresas por nome, CNPJ ou socio

Params: q, type, uf, cnae, situacao, page, limit

GET/v1/empresas/:cnpj

Dados completos de uma empresa

Params: cnpj (14 digitos)

GET/v1/empresas/:cnpj/socios

Quadro societario

Params: cnpj

GET/v1/empresas/:cnpj/estabelecimentos

Filiais e estabelecimentos

Params: cnpj

GET/v1/empresas/:cnpj/enrichment

Dados de redes sociais e reputacao

Params: cnpj

GET/v1/empresas/:cnpj/risk

Score de risco detalhado

Params: cnpj

GET/v1/empresas/:cnpj/graph

Grafo de relacionamentos societarios

Params: cnpj, depth

GET/v1/empresas/:cnpj/history

Historico de mudancas cadastrais

Params: cnpj

POST/v1/batch/enrich

Enriquecimento em lote (CSV upload)

Params: file, fields

GET/v1/batch/:jobId

Status de job de enriquecimento

Params: jobId

POST/v1/monitoring

Monitorar CNPJ para mudancas

Params: cnpj, fields, webhookUrl

GET/v1/monitoring

Listar monitoramentos ativos

Params: -

DELETE/v1/monitoring/:id

Remover monitoramento

Params: id

GET/v1/monitoring/alerts

Listar alertas recentes

Params: since

GET/v1/usage

Uso do mes atual

Params: -

GET/v1/health

Status da API

Params: -

Exemplo completo

// Node.js
const response = await fetch(
  'https://api.veridata.com.br/v1/search?q=petrobras&limit=5',
  { headers: { 'Authorization': 'Bearer vd_live_...' } }
);
const { data, meta } = await response.json();

console.log(data[0].razaoSocial);
// → "PETROLEO BRASILEIRO S.A. PETROBRAS"

console.log(data[0].score);
// → 847

console.log(meta.total);
// → 3

SDKs

Node.js / TypeScript

npm install @veridata/sdkEm breve

Python

pip install veridataEm breve

PHP

composer require veridata/sdkEm breve