Consultar informações de empresas

Request

Busca informações detalhadas de empresa por CNPJ.

Formato da resposta: a API sempre devolve uma lista de objetos (normalmente com um único item), nunca um objeto único. Acesse o primeiro elemento antes de ler os campos.

Cobrança e carência de 24 horas: cada consulta com retorno debita 1 crédito, exceto quando o mesmo CNPJ já foi consultado pela sua empresa nas últimas 24 horas — nesse caso a resposta vem completa, sem novo débito. A carência é por documento e vale para a conta inteira: consultas feitas por chaves de API diferentes da mesma empresa compartilham a mesma janela. Consulta sem retorno não gera cobrança nem inicia a carência, e o documento com ou sem pontuação conta como o mesmo CNPJ.

Campo ip: o primeiro item da lista recebe um campo extra ip, com o IP de origem registrado na operação. É um dado de auditoria da operação, não da empresa, e não aparece nos demais itens. Numa consulta isenta pela carência, o valor é o IP da operação que gerou a cobrança original.

Security

ApiKeyAuth

Query

cnpjstring^\d{14}$required

CNPJ da empresa (apenas números). Envie sempre o documento completo, com os zeros à esquerda; a API normaliza a entrada para dígitos. O CNPJ devolvido na resposta deve ser tratado como string.

Example:cnpj=12345678000199

fieldsstring

Campos específicos a retornar (separados por vírgula)

Example:fields=company_name,cnpj,emails,partners,related_company_members

curl -i -X GET \
  'https://docs.datastone.com.br/_mock/api/companies/?cnpj=12345678000199&fields=company_name%2Ccnpj%2Cemails%2Cpartners%2Crelated_company_members' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Informações da empresa retornadas com sucesso

Bodyapplication/json

Array [

cnpjstring

Example:"12345678000199"

company_namestring

Example:"FULANO DE TAL EXEMPLO"

trading_namestring

Example:"EMPRESA EXEMPLO"

creation_datestring, (date)

Example:"2022-01-01"

agestring

Example:"3 anos 3 meses"

business_sizestring

Example:"ME"

city_ufstring

Example:"CIDADE EXEMPLO, EX"

cnae_codeinteger

Example:9511800

cnae_descriptionstring

Example:"Reparação e manutenção de computadores e de equipamentos periféricos"

registry_situationstring

Example:"ATIVA"

addressesArray of objects

branch_officesArray of objects

Filiais da empresa

partnersArray of objects

Lista de sócios da empresa

employee_countstring

Faixa de quantidade de funcionários

Example:"DE 50 A 99 FUNCIONARIOS"

estimated_revenuestring

Faixa de faturamento estimado

Example:"DE R$ 100 MM ATÉ R$ 250 MM"

headquarter_typestring

Tipo da unidade (MATRIZ ou FILIAL)

Example:"MATRIZ"

juridical_typestring

Natureza jurídica da empresa

Example:"Sociedade Anônima Fechada"

juridical_type_idinteger

ID da natureza jurídica

Example:2054

segmentstring

Segmento de atuação

Example:"Atividades Profissionais, Científicas e Técnicas"

share_capitalstring

Capital social da empresa

Example:"1083642898.00"

simple_simeistring or null

Informação sobre Simples Nacional / SIMEI

matriz_filial_countinteger

Quantidade de filiais do grupo

Example:3

legal_representativeArray of objects

Representantes legais da empresa

emailsArray of objects

land_linesArray of objects

Telefones fixos

mobile_phonesArray of objects

Telefones celulares

related_company_membersArray of objects

Funcionários e ex-funcionários da empresa com perfil identificado. Diferenciados pelo campo position_status: "Última informação obtida" (atual) ou "Informação histórica" (ex-funcionário).

related_companiesArray of objects

Empresas relacionadas (grupo econômico, participações societárias)

related_personsArray of objects

Pessoas físicas relacionadas à empresa (sócios/diretores com detalhes estendidos)

related_emailsArray of objects

Emails de empresas relacionadas (filiais, grupo econômico)

]

Response

[
  {
    "cnpj": "12345678000199",
    "company_name": "FULANO DE TAL EXEMPLO",
    "trading_name": "EMPRESA EXEMPLO",
    "creation_date": "2022-01-01",
    "age": "3 anos 3 meses",
    "business_size": "ME",
    "city_uf": "CIDADE EXEMPLO, EX",
    "cnae_code": 9511800,
    "cnae_description": "Reparação e manutenção de computadores e de equipamentos periféricos",
    "registry_situation": "ATIVA",
    "addresses": [ … ],
    "branch_offices": [ … ],
    "partners": [ … ],
    "employee_count": "DE 50 A 99 FUNCIONARIOS",
    "estimated_revenue": "DE R$ 100 MM ATÉ R$ 250 MM",
    "headquarter_type": "MATRIZ",
    "juridical_type": "Sociedade Anônima Fechada",
    "juridical_type_id": 2054,
    "segment": "Atividades Profissionais, Científicas e Técnicas",
    "share_capital": "1083642898.00",
    "simple_simei": "string",
    "matriz_filial_count": 3,
    "legal_representative": [ … ],
    "emails": [ … ],
    "land_lines": [ … ],
    "mobile_phones": [ … ],
    "related_company_members": [ … ],
    "related_companies": [ … ],
    "related_persons": [ … ],
    "related_emails": [ … ]
  }
]