Consultas CNPJ e CPF

Consultar CNPJ

GET /queries/cnpj/:cnpj

Consulta dados cadastrais de uma empresa pelo CNPJ.

Autenticação

Authorization: Bearer {token}

Parâmetros de URL

Campo	Tipo	Descrição
cnpj	string	CNPJ (apenas números, 14 dígitos)

Exemplo

curl https://api.engineapi.com.br/queries/cnpj/12345678000190 \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta (200)

{
  "cnpj": "12345678000190",
  "razaoSocial": "EMPRESA EXEMPLO LTDA",
  "nomeFantasia": "EXEMPLO",
  "situacaoCadastral": "ATIVA",
  "endereco": {
    "logradouro": "Rua das Flores",
    "numero": "100",
    "bairro": "Centro",
    "municipio": "São Paulo",
    "uf": "SP",
    "cep": "01000000"
  },
  "atividadePrincipal": {
    "codigo": "6201-5/01",
    "descricao": "Desenvolvimento de programas de computador sob encomenda"
  }
}

---

Invalidar Cache CNPJ

DELETE /queries/cnpj/:cnpj/cache

Invalida o cache da consulta para forçar nova busca.

curl -X DELETE https://api.engineapi.com.br/queries/cnpj/12345678000190/cache \
  -H "Authorization: Bearer SEU_TOKEN"

---

Consultar CPF

GET /queries/cpf/:cpf

Consulta dados de uma pessoa física pelo CPF.

Parâmetros de URL

Campo	Tipo	Descrição
cpf	string	CPF (apenas números, 11 dígitos)

Exemplo

curl https://api.engineapi.com.br/queries/cpf/12345678909 \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta (200)

{
  "cpf": "12345678909",
  "nome": "JOAO DA SILVA",
  "situacaoCadastral": "REGULAR",
  "dataNascimento": "1990-01-15"
}

---

Excluir Dados CPF (LGPD Art. 18)

DELETE /queries/cpf/:cpf

Exclui os dados armazenados do CPF conforme LGPD Art. 18.

curl -X DELETE https://api.engineapi.com.br/queries/cpf/12345678909 \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta (200)

{
  "success": true,
  "message": "Dados do CPF 123.456.789-09 excluídos conforme LGPD Art. 18"
}