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.