--- title: "Dados básicos" method: POST path: "/queries" tags: ["Dados instituicionais"] --- # Dados básicos `POST /queries` ## Request - Base URL: `https://api.deskdata.com.br` - URL: `https://api.deskdata.com.br/queries` - Auth: HTTP bearer ## Headers - `Authorization` string, required ## Request body - object - `type` 'companies', required: Tipo da busca - `key_type` 'cnpj' | 'name' | 'email' | 'phone', required: Tipo da chave de busca - `key_value` string, required: Valor da chave de busca - `datasets` basic, required: Lista de conjuntos de dados desejados ## Response `200` OK - ResponseQueriesPostSuccess - `status` object: Status do retorno da requisição - `code` integer: Código do retorno da requisição - `message` string: Mensagem do retorno da requisição - `details` string: Detalhes do retorno da requisição - `data` object: Dados resultantes - `basic` object: Informações do conjunto de dados 'basic' sobre a empresa consultada - `founding_date` string, date-time: Data de fundação da empresa - `closing_date` string, date-time: Data de encerramento da empresa, quando aplicável - `age` integer: Anos desde a fundação da empresa no momento da consulta - `is_headquarter` boolean: Indica se o CNPJ consultado corresponde à matriz - `headquarter_state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO': UF da matriz - `is_conglomerate` boolean: Indica se a empresa é identificada como conglomerado - `size` 'DEMAIS' | 'EPP' | 'ME': Porte da empresa conforme classificação disponível - `tax_regime` 'EIRELI' | 'EPP' | 'ISENTO' | 'LTDA' | 'LUCRO PRESUMIDO' | 'LUCRO REAL' | 'ME' | 'MEI' | 'NAO ATIVA' | 'S.A.' | 'SIMPLES' | 'ADMINISTRACAO PUBLICA': Regime tributário da empresa - `legal_nature` object: Informações sobre a natureza jurídica da empresa - `code` string: Código da natureza jurídica - `description` string: Descrição da natureza jurídica - `name` object: Informações sobre a razão social e nome fantasia - `legal_name` string: Nome empresarial (razão social) - `trade_name` string: Nome fantasia - `legal_name_uniqueness` number, float: Unicidade do nome empresarial, sendo '0' muito comum e '1' única - `trade_name_uniqueness` number, float: Unicidade do nome fantasia, sendo '0' muito comum e '1' único - `legal_name_input_match` number, float: Similaridade entre o nome empresarial retornado e o nome informado na chave de busca 'name', entre 0 e 1 - `trade_name_input_match` number, float: Similaridade entre o nome fantasia retornado e o nome informado na consulta na chave de busca 'name', entre 0 e 1 - `tax_id` object: Informações sobre o CNPJ - `country` string: País de emissão - `origin` string: Fonte de origem do identificador fiscal - `number` string: Número do CNPJ - `status` 'ATIVA' | 'ATIVA - EMPRESA DOMICILIADA NO EXTERIOR' | 'BAIXADA' | 'CNPJ DOES NOT EXIST IN RECEITA FEDERAL DATABASE' | 'INAPTA' | 'NULA' | 'NULA - EMPRESA DOMICILIADA NO EXTERIOR' | 'SUSPENSA' | 'SUSPENSA - EMPRESA DOMICILIADA NO EXTERIOR': Status cadastral do CNPJ - `status_reason` string: Motivo do status cadastral - `status_start_date` string, date-time: Data em que o status cadastral foi registrado - `status_last_seen_date` string, date-time: Última data em que o status cadastral foi observado - `special_status` string: Situação especial do CNPJ, quando aplicável - `special_status_start_date` string, date-time: Data inicial da situação especial, quando aplicável - `state_registration` object[]: Inscrições estaduais vinculadas à empresa - `issuing_state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO': UF da inscrição estadual - `issuing_agency` string: Órgão emissor ou complemento da inscrição, quando disponível - `number` string: Número da inscrição estadual - `suframa` object: Informações sobre o registro no SUFRAMA - `number` string: Número do registro no SUFRAMA - `nire` object: Informações sobre o NIRE - `number` string: Número do NIRE - `company_size` string: Porte da empresa registrado no NIRE - `headquarters_type` string: Tipo de sede registrado no NIRE - `headquarters_capital` number: Capital da sede registrado no NIRE - `last_update_date` string, date-time: Data da última atualização do NIRE - `comex` object: Informações sobre habilitação para operar no comércio exterior - `status` string: Status da habilitação para operar no comércio exterior - `last_update_date` string, date-time: Data da última atualização do status da habilitação para operar no comércio exterior - `capital_value` string: Capital social em valor numérico - `capital_words` string: Capital social escrito por extenso - `activities` object[]: Atividades econômicas da empresa conforme o CNAE - `is_main` boolean: Indica se é a atividade econômica principal - `code` string: Código da atividade econômica - `subclass` string: Descrição da subclasse da atividade econômica - `class` string: Descrição da classe da atividade econômica - `group` string: Descrição do grupo da atividade econômica - `division` string: Descrição da divisão da atividade econômica - `alternative_ids` object[]: Identificadores alternativos da empresa - `type` string: Tipo do identificador alternativo - `number` string: Número do identificador alternativo - `history` object: Histórico de alterações cadastrais da empresa - `has_changed_trade_name` boolean: Indica se houve alteração no nome fantasia - `has_changed_tax_regime` boolean: Indica se houve alteração no regime tributário - `trade_names` object[]: Histórico de nomes fantasia - `value` string: Nome fantasia - `start_date` string, date-time: Data inicial de vigência - `end_date` string, date-time: Data final de vigência, quando aplicável - `tax_regimes` object[]: Histórico de regimes tributários - `value` string: Regime tributário - `start_date` string, date-time: Data inicial de vigência - `end_date` string, date-time: Data final de vigência, quando aplicável - `first_seen_date` string, date-time: Primeira data em que a empresa foi observada - `last_seen_date` string, date-time: Última data em que a empresa foi observada ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `500`: Internal Server Error --- [API](https://skmtc.dev/deskdata/apis/consultas-a-empresas.md) - [All operations](https://skmtc.dev/deskdata/apis/consultas-a-empresas/llms.txt) - [OpenAPI document](https://skmtc.dev/deskdata/apis/consultas-a-empresas/revisions/8819beac1812?raw)