Consulta grupo econômico

Retorna o agregado estatístico do grupo econômico de um CNPJ — totais de empresas, faixas de idade/renda/funcionários, distribuições por CNAE, UF e cidade, e os CNPJs do grupo (company_doc_numbers).

O recorte do grupo é definido por subtype — um por requisição, e cada requisição conta como uma consulta: household, household_activity, rfcontact, owners ou legal_representative. Para mais de um recorte, faça uma requisição por subtipo.

POST /api/consultas/grupo-economico

Consulta grupo econômico

cURL

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

200

Example

{
  "statusCode": 200,
  "message": "Consulta concluída com sucesso",
  "timestamp": "2026-07-28T18:00:00.000Z",
  "path": "/api/consultas/grupo-economico",
  "result": {
    "subtype": "owners",
    "title": "Empresas com o mesmo quadro societário",
    "query_id": "b7a76771-b788-4ad4-bc1d-32eeddf95f3b",
    "query_date": "2026-08-03T19:58:16.9760542Z",
    "elapsed_milliseconds": 99,
    "status_code": 0,
    "status_message": "OK",
    "group": {
      "total_companies": 1,
      "total_branches": 0,
      "total_active_companies": 1,
      "total_inactive_companies": 0,
      "total_simples_companies": 0,
      "total_meis": 0,
      "total_headquarter": 1,
      "min_company_age": 16,
      "max_company_age": 16,
      "average_company_age": 16,
      "min_activity_level": 0.28125,
      "max_activity_level": 0.28125,
      "average_activity_level": 0.28125,
      "total_income_range": "empresa isenta",
      "min_income_range": "empresa isenta",
      "max_income_range": "empresa isenta",
      "average_income_range": "empresa isenta",
      "total_employees_range": "sem informacao",
      "min_employees_range": "sem vinculos",
      "max_employees_range": "sem informacao",
      "average_employee_range": "sem informacao",
      "total_declared_value": 0,
      "min_declared_value": 0,
      "max_declared_value": 0,
      "average_declared_value": 0,
      "total_number_of_owners": 0,
      "min_number_of_owners": 0,
      "max_number_of_owners": 0,
      "average_number_of_owners": 0,
      "total_sites": 10,
      "min_sites": 10,
      "max_sites": 10,
      "average_sites": 10,
      "total_marketplace_stores": 0,
      "min_marketplace_stores": 0,
      "max_marketplace_stores": 0,
      "average_marketplace_stores": 0,
      "total_unique_cnaes": 1,
      "total_unique_cities": 1,
      "total_unique_states": 1,
      "total_tax_status_ativa": 1,
      "total_tax_status_baixada": 0,
      "total_regime_isenta_irpj": 1,
      "total_regime_lucro_presumido": 0,
      "total_regime_lucro_real": 0,
      "total_regime_nao_ativa": 0,
      "total_regime_simples": 0,
      "total_regime_mei": 0,
      "total_sociedade_anonima_fechada": 0,
      "total_sociedade_anonima_aberta": 0,
      "total_sociedade_empresaria_limitada": 0,
      "total_sociedade_simples_limitada": 0,
      "total_associacao_privada": 1,
      "total_empresario_individual": 0,
      "cnae_distribution": {
        "6201501": 1
      },
      "state_distribution": {
        "AC": 0,
        "AL": 0,
        "AM": 0,
        "AP": 0,
        "BA": 0,
        "CE": 0,
        "DF": 0,
        "ES": 0,
        "GO": 0,
        "MA": 0,
        "MG": 0,
        "MS": 0,
        "MT": 0,
        "PA": 0,
        "PB": 0,
        "PE": 0,
        "PI": 0,
        "PR": 0,
        "RJ": 0,
        "RN": 0,
        "RO": 0,
        "RR": 0,
        "RS": 0,
        "SC": 0,
        "SE": 0,
        "SP": 1,
        "TO": 0,
        "EX": 0
      },
      "city_distribution": {
        "SAO PAULO": 1
      },
      "company_doc_numbers": [
        "11222333000181"
      ]
    }
  }
}

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"

subtype · enum<string> · obrigatório

Recorte do grupo econômico a consultar — um por requisição, cada uma conta como uma consulta: household (empresas de qualquer atividade no mesmo endereço), household_activity (empresas com atividade semelhante no endereço), rfcontact (empresas com o mesmo contato na Receita Federal), owners (empresas com o mesmo quadro societário) ou legal_representative (empresas com o mesmo representante legal).

Opções disponíveis: household, household_activity, rfcontact, owners, legal_representative

Exemplo:

"owners"

Resposta

200

application/json

Agregado do grupo econômico no recorte pedido. As faixas (*_income_range, *_employees_range) são textuais e vêm em minúsculas (ex.: "empresa isenta"); já as chaves de state_distribution (todas as UFs, zeradas quando não há empresa — inclui EX) e city_distribution vêm em MAIÚSCULAS, e cnae_distribution usa o código numérico puro. O detalhe de cada empresa não vem no agregado — use os CNPJs de company_doc_numbers para consultas individuais.

The response is of type object.