Consulta dados cadastrais de uma empresa

Retorna os dados cadastrais de um CNPJ: razão social, nome fantasia, situação cadastral, natureza jurídica, capital social, CNAEs, endereços e quadro societário.

POST /api/consultas/dados-empresa

Consulta dados cadastrais de uma empresa

cURL

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/consultas/dados-empresa \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "document": "11222333000181"
}
'

200

Example

{
  "statusCode": 200,
  "message": "Consulta concluída com sucesso",
  "timestamp": "2026-07-28T18:00:00.000Z",
  "path": "/api/consultas/dados-empresa",
  "result": {
    "document": "11222333000181",
    "officialName": "ASSOCIACAO EXEMPLO DE ENSINO FUNDAMENTAL",
    "tradeName": "ASSOCIACAO EXEMPLO",
    "taxIdStatus": "ATIVA",
    "taxIdStatusDate": "2026-07-20",
    "foundedDate": "2009-09-02",
    "legalNatureCode": "3999",
    "legalNatureDescription": "ASSOCIACAO PRIVADA",
    "shareCapital": 0,
    "headquarterState": "RS",
    "activities": [
      {
        "code": "8550301",
        "description": "ADMINISTRACAO DE CAIXAS ESCOLARES"
      }
    ],
    "addresses": [
      {
        "street": "R DAS FLORES",
        "number": "70",
        "complement": null,
        "neighborhood": "CENTRO",
        "city": "PORTO ALEGRE",
        "state": "RS",
        "zipCode": "90010-000",
        "isMain": true,
        "updatedAt": "2026-07-20",
        "formatted": "R DAS FLORES, 70, CENTRO, PORTO ALEGRE - RS, CEP 90010-000"
      }
    ],
    "partners": [
      {
        "document": "52998224725",
        "name": "MARIA DE SOUZA",
        "participationType": "PRESIDENTE",
        "participationPercentage": 0,
        "entryDate": null
      }
    ]
  }
}

Autorizações

x-api-key · string · header · obrigatório

Corpo

application/json

document · string · obrigatório

CNPJ da empresa consultada, com ou sem máscara. Separadores (incluindo a barra) são aceitos e ignorados. O dígito verificador é validado antes da consulta. A consulta é de pessoa jurídica — CPF não é aceito.

Exemplo:

"11222333000181"

Resposta

200

application/json

Dados da empresa consultada. addresses e partners seguem uma convenção própria: null significa que aquele bloco não pôde ser obtido (o restante da consulta é entregue mesmo assim), e [] que o provedor respondeu e a empresa não tem registros daquele tipo. Datas em ISO yyyy-MM-dd, CEP com máscara e documentos só com dígitos. O quadro societário vem completo, sem filtro por tipo de participação, e contém documento e nome de terceiros.

The response is of type object.