Documentação da API DataX: CPF, CNPJ e sócios

Começo rápido

Crie sua conta no portal e comece pelo teste grátis de 24 horas.
No portal, gere a sua chave de API.
Faça a primeira chamada. A consulta de limite é um bom teste: ela confirma que a chave funciona, mostra o seu plano e não consome requisições.

cURL

curl https://api.datax.plus/v1/plano/limite \
  -H "api-key: $DATAX_KEY"

● 200 OKapplication/json

{
  "planoNome": "Intermediário",
  "consumoDia": 42,
  "limiteDiario": 5000,
  "consumoMinuto": 1,
  "limitePorMinuto": 120
}

Autenticação

Toda chamada leva a chave de API no cabeçalho api-key. A chave é gerada no portal, onde você também acompanha o limite e o consumo.

Cabeçalho

api-key: SUA_CHAVE

Guarde a chave no servidor, em variável de ambiente ou cofre de segredos. Nunca coloque a chave no navegador, num aplicativo ou num repositório de código.

Formato

Base: https://api.datax.plus, só por HTTPS.
Respostas em JSON (application/json), com nomes de campos em português e em camelCase.
CPF (11 dígitos) e CNPJ (14 dígitos): envie só os números, sem pontos, barras ou traços.
Telefone: DDD e número, só dígitos, como 11987654321.
Campos sem informação podem vir como null ou como lista vazia. Trate os dois casos.
Os exemplos desta página são resumidos e usam valores fictícios. A resposta pode trazer campos além dos listados.

Limites e consumo

Cada plano tem um limite de chamadas por dia e por minuto. Cada chamada à API consome 1 requisição do limite diário, com duas exceções: a consulta de sócios consome 1 por sócio retornado, e o lote, 1 por CPF ou CNPJ válido. O limite por minuto conta chamadas: a consulta de sócios conta 1 no minuto, mesmo que desconte vários sócios do limite diário. As consultas de limite e de consumo não consomem requisições, nem as recusadas por estarem fora do plano (403).

Limites de cada plano da DataX
Plano	Preço	Chamadas/dia	Chamadas/min	Consultas
Teste 24 horas	Grátis	20 no período	20	Pessoa física, ficha do CNPJ e sócios
Entrada	R$ 99/mês	1.000	30	Pessoa física
Intermediário	R$ 299/mês	5.000	120	Pessoa física, ficha do CNPJ e sócios
Avançado	R$ 599/mês	20.000	300	Tudo, inclusive empresas recentes e lote

Chamadas acima do limite por minuto ou por dia são recusadas. Para acompanhar, use a consulta de limite ou o portal.

Erros

Os erros vêm em JSON, com um código e uma mensagem em português:

401 Unauthorizedapplication/json

{
  "detail": {
    "erro": {
      "codigo": "UNAUTHORIZED",
      "mensagem": "api-key ausente ou com formato inválido."
    }
  }
}

Códigos de status da API
Status	Quando acontece
`200`	Consulta feita com sucesso.
`401`	Chave de API ausente, inválida ou com formato errado.
`403`	A consulta não está incluída no seu plano. Não consome requisições.
`422`	Parâmetros faltando ou inválidos, como um campo obrigatório ausente no corpo.

Empresas

Ficha do CNPJ

GET/v1/empresas/{cnpj}

Teste grátis · Intermediário · Avançado

Dados cadastrais completos da empresa: razão social, situação, atividades, porte, Simples e MEI, endereço, contatos da empresa e quadro societário.

cURL

curl https://api.datax.plus/v1/empresas/11222333000181 \
  -H "api-key: $DATAX_KEY"

● 200 OKapplication/json

{
  "cnpj": "11222333000181",
  "razaoSocial": "EXEMPLO TECNOLOGIA LTDA",
  "nomeFantasia": "EXEMPLO TECH",
  "situacaoCadastral": "ATIVA",
  "dataAbertura": "2015-06-02",
  "capitalSocial": 100000.0,
  "atividadePrincipal": {
    "codigo": "6201501",
    "descricao": "Desenvolvimento de programas de computador sob encomenda"
  },
  "simples": { "optante": true, "mei": false },
  "endereco": { "municipio": "SÃO PAULO", "uf": "SP", "cep": "01310100" },
  "contatos": { "email": "contato@...", "telefones": ["1133..."] },
  "socios": [
    {
      "nome": "JOÃO P. LIMA",
      "qualificacao": "Sócio-Administrador",
      "dataEntrada": "2015-06-02"
    }
  ]
}

Campos da ficha do CNPJ
Campo	O que traz
`cnpj`, `cnpjRaiz`	CNPJ consultado e a raiz (8 primeiros dígitos)
`razaoSocial`, `nomeFantasia`	Nome empresarial e nome fantasia
`situacaoCadastral`	Situação na Receita Federal, como ATIVA ou BAIXADA
`dataAbertura`	Data de abertura
`matrizFilial`	Se o CNPJ é matriz ou filial
`naturezaJuridica`, `porte`, `capitalSocial`	Natureza jurídica, porte e capital social
`atividadePrincipal`, `atividadesSecundarias`	Atividades (CNAE), com código e descrição
`simples`	Se é optante do Simples Nacional (`optante`) e se é MEI (`mei`)
`endereco`	Logradouro, número, complemento, bairro, município, UF e CEP
`contatos`	E-mail e telefones da empresa informados no cadastro
`socios`	Quadro societário: nome, CPF, qualificação e data de entrada de cada sócio

Sócios de um CNPJ (telefone e e-mail)

POST/v1/empresas/{cnpj}/socios

Teste grátis · Intermediário · Avançado

Devolve os sócios pessoa física da empresa com nome, CPF, qualificação, telefones e e-mails. A chamada não tem corpo e consome 1 requisição por sócio retornado; o campo unidadesConsumidas mostra o total. A página da API de sócios tem a referência completa e exemplos em Node.js e Python.

cURL

curl -X POST \
  https://api.datax.plus/v1/empresas/11222333000181/socios \
  -H "api-key: $DATAX_KEY"

● 200 OKapplication/json

{
  "cnpj": "11222333000181",
  "socios": [
    {
      "nome": "JOÃO P. LIMA",
      "cpf": "12345678909",
      "qualificacao": "Sócio-Administrador",
      "telefones": ["+55119..."],
      "emails": ["joao.lima@..."]
    }
  ],
  "unidadesConsumidas": 1
}

Empresas recentes

GET/v1/empresas/recentes

Avançado

Lista empresas abertas recentemente, com CNPJ, razão social, data de abertura e UF. Útil para prospectar negócios novos.

Query: limite: quantas empresas trazer, de 1 a 100. Padrão: 20.

cURL

curl "https://api.datax.plus/v1/empresas/recentes?limite=50" \
  -H "api-key: $DATAX_KEY"

● 200 OKapplication/json

{
  "empresas": [
    {
      "cnpj": "11222333000181",
      "razaoSocial": "EXEMPLO TECNOLOGIA LTDA",
      "dataAbertura": "2026-11-02",
      "uf": "SP"
    }
  ]
}

Pessoas

Ficha do CPF

GET/v1/pessoas/{cpf}

Teste grátis · Entrada · Intermediário · Avançado

Dados cadastrais da pessoa, com telefones, e-mails e endereços.

cURL

curl https://api.datax.plus/v1/pessoas/12345678909 \
  -H "api-key: $DATAX_KEY"

● 200 OKapplication/json

{
  "cpf": "12345678909",
  "nome": "MARIA S. OLIVEIRA",
  "dataNascimento": "1988-03-14",
  "situacaoCadastral": "REGULAR",
  "falecido": false,
  "telefones": [
    { "ddd": "11", "numero": "9...", "numeroCompleto": "+55119...", "whatsapp": true }
  ],
  "emails": ["maria.o@..."],
  "enderecos": [
    {
      "logradouro": "...", "numero": "...", "bairro": "...",
      "municipio": "SÃO PAULO", "uf": "SP", "cep": "..."
    }
  ]
}

Campos da ficha do CPF
Campo	O que traz
`cpf`, `nome`	CPF consultado e nome completo
`dataNascimento`, `sexo`	Data de nascimento e sexo
`situacaoCadastral`	Situação do CPF na Receita Federal
`falecido`, `dataObito`	Indicação de óbito e a data, quando houver
`telefones`	Lista de telefones, com DDD, número, número completo, tipo, operadora e se tem WhatsApp
`emails`	Lista de e-mails
`enderecos`	Lista de endereços, com logradouro, número, complemento, bairro, município, UF e CEP

Telefone e e-mail de um CPF

GET/v1/pessoas/{cpf}/basico

Teste grátis · Entrada · Intermediário · Avançado

Só os contatos da pessoa: telefones e e-mails, sem o restante da ficha. Use quando você já tem o cadastro e quer apenas o contato.

cURL

curl https://api.datax.plus/v1/pessoas/12345678909/basico \
  -H "api-key: $DATAX_KEY"

● 200 OKapplication/json

{
  "cpf": "12345678909",
  "telefones": [
    { "ddd": "11", "numero": "9...", "numeroCompleto": "+55119...", "whatsapp": true }
  ],
  "emails": ["maria.o@..."]
}

Busca de pessoa por nome

POST/v1/pessoas/busca

Teste grátis · Entrada · Intermediário · Avançado

Encontra pessoas pelo nome e devolve os candidatos com CPF, data de nascimento e UF. Depois, consulte a ficha do CPF escolhido.

Corpo (JSON): nome: nome da pessoa. Obrigatório.; uf: sigla do estado, para filtrar. Opcional.; buscaAproximada: por padrão (false) a busca é pelo nome exato; com true, o primeiro nome vale como prefixo. Opcional.

cURL

curl -X POST https://api.datax.plus/v1/pessoas/busca \
  -H "api-key: $DATAX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nome": "MARIA SILVA OLIVEIRA", "uf": "SP"}'

● 200 OKapplication/json

{
  "candidatos": [
    {
      "nome": "MARIA SILVA OLIVEIRA",
      "cpf": "12345678909",
      "dataNascimento": "1988-03-14",
      "uf": "SP"
    }
  ]
}

Reverso de telefone

GET/v1/pessoas/telefone/{numero}

Teste grátis · Entrada · Intermediário · Avançado

Descobre o titular de um telefone: nome, CPF, operadora e se o número tem WhatsApp.

cURL

curl https://api.datax.plus/v1/pessoas/telefone/11987654321 \
  -H "api-key: $DATAX_KEY"

● 200 OKapplication/json

{
  "resultados": [
    {
      "numero": "11987654321",
      "titular": "MARIA S. OLIVEIRA",
      "cpf": "12345678909",
      "operadora": "...",
      "whatsapp": true
    }
  ]
}

Reverso de e-mail

GET/v1/pessoas/email/{email}

Teste grátis · Entrada · Intermediário · Avançado

Descobre a pessoa dona de um e-mail: nome e CPF. Codifique o e-mail na URL (por exemplo, com encodeURIComponent).

cURL

curl https://api.datax.plus/v1/pessoas/email/maria.oliveira%40exemplo.com \
  -H "api-key: $DATAX_KEY"

● 200 OKapplication/json

{
  "resultados": [
    {
      "email": "maria.oliveira@exemplo.com",
      "nome": "MARIA S. OLIVEIRA",
      "cpf": "12345678909"
    }
  ]
}

Pessoas por endereço

GET/v1/pessoas/enderecos/busca

Teste grátis · Entrada · Intermediário · Avançado

Encontra as pessoas ligadas a um CEP ou a um endereço específico. Buscas genéricas, como só a cidade ou só o estado, são recusadas.

Query: Informe cep, ou logradouro com cidade e estado.; numero e bairro: opcionais, para restringir o endereço.

cURL

curl "https://api.datax.plus/v1/pessoas/enderecos/busca?cep=01310100&numero=1000" \
  -H "api-key: $DATAX_KEY"

● 200 OKapplication/json

{
  "resultados": [
    {
      "logradouro": "...", "numero": "1000", "bairro": "...",
      "municipio": "SÃO PAULO", "uf": "SP", "cep": "01310100",
      "nome": "MARIA S. OLIVEIRA", "cpf": "12345678909"
    }
  ]
}

Lote misto CPF/CNPJ

POST/v1/bureau/lote

Avançado

Envia de 1 a 100 itens de uma vez, somando CPFs e CNPJs. O processamento é assíncrono: o resultado é entregue na URL de webhook que você informar, com assinatura HMAC-SHA256. Não há consulta do resultado por polling. Cada CPF ou CNPJ válido conta como 1 chamada no limite diário.

Corpo (JSON): cpfs: lista de CPFs, só números.; cnpjs: lista de CNPJs, só números.; webhookUrl: URL HTTPS do seu sistema que vai receber o resultado.; webhookSecret: segredo de 16 a 128 caracteres para você validar que a entrega veio da DataX. Opcional.

cURL

curl -X POST https://api.datax.plus/v1/bureau/lote \
  -H "api-key: $DATAX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cpfs": ["12345678909"],
    "cnpjs": ["11222333000181"],
    "webhookUrl": "https://seu-sistema.com.br/webhooks/datax",
    "webhookSecret": "um-segredo-com-16-ou-mais-caracteres"
  }'

Para detalhes da entrega no webhook, fale com o suporte pelo Telegram.

Conta

Limite do plano

GET/v1/plano/limite

Todos os planos

Mostra o plano atual e quanto já foi usado do limite do dia e do minuto. Não consome requisições.

Campos da consulta de limite
Campo	O que traz
`planoNome`	Nome do plano
`consumoDia`, `limiteDiario`	Chamadas usadas hoje e o limite diário
`consumoMinuto`, `limitePorMinuto`	Chamadas no minuto atual e o limite por minuto

Consumo

GET/v1/plano/consumo

Todos os planos

Extrato do consumo dos últimos 30 dias, agregado por dia, sem repetir os dados consultados. Não consome requisições.

cURL

curl https://api.datax.plus/v1/plano/consumo \
  -H "api-key: $DATAX_KEY"

Começo rápido

Autenticação

Formato

Limites e consumo

Erros

Empresas

Ficha do CNPJ

Sócios de um CNPJ (telefone e e-mail)

Empresas recentes

Pessoas

Ficha do CPF

Telefone e e-mail de um CPF

Busca de pessoa por nome

Reverso de telefone

Reverso de e-mail

Pessoas por endereço

Lote misto CPF/CNPJ

Conta

Limite do plano

Consumo

Faça a primeira chamada hoje, com o teste grátis de 24 horas.