> ## Documentation Index > Fetch the complete documentation index at: https://docs.sherlocker.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Vinculos societarios > Busca reversa: retorna todas as empresas onde a pessoa consta como socia ou administradora, cada uma com seu quadro societario completo (socios). Essencial para mapear a rede empresarial de um investigado e percorrer graus de conexao sem chamadas adicionais. ## OpenAPI ````yaml /openapi/empresas.json get /empresas/cpf/{cpf} openapi: 3.0.0 info: title: Sherlocker Empresas API description: >- Perfil completo de empresas: dados cadastrais, quadro societario, funcionarios, dividas, veiculos, imoveis, processos, aeronaves, patentes, trabalhista, rural, beneficios fiscais e compliance. Ponto de entrada para investigacoes empresariais. version: '2.0' servers: - url: https://221b-api.sherlocker.com.br/api/v1 security: - tokenAuth: [] paths: /empresas/cpf/{cpf}: get: tags: - Busca Reversa summary: Vinculos societarios description: >- Busca reversa: retorna todas as empresas onde a pessoa consta como socia ou administradora, cada uma com seu quadro societario completo (socios). Essencial para mapear a rede empresarial de um investigado e percorrer graus de conexao sem chamadas adicionais. operationId: getSociedadesByCpf parameters: - name: cpf in: path required: true description: CPF do socio (11 digitos) schema: type: string example: '12345678901' - name: nome in: query required: false description: Nome do socio (melhora precisao) schema: type: string - name: limit in: query required: false description: Maximo de registros retornados (max 200, padrao 50) schema: type: integer default: 50 maximum: 200 example: 50 - name: offset in: query required: false description: Numero de registros a pular (padrao 0) schema: type: integer default: 0 example: 0 responses: '200': description: Lista de empresas onde a pessoa consta como socia ou administradora content: application/json: schema: type: object properties: empresas: type: array items: $ref: '#/components/schemas/EmpresaResponse' example: empresas: - documento: 33.000.167/0001-01 tipo_documento: CNPJ cnpj_basico: '33000167' razao_social: Petroleo Brasileiro S A Petrobras nome_fantasia: Petrobras - Edise situacao: Ativa data_situacao: '2005-11-03' motivo_situacao: Sem Motivo data_abertura: '1966-09-28' capital_social: 205431960490.52 porte: Média ou Grande Porte matriz_filial: Matriz natureza_juridica: codigo: '2038' descricao: Sociedade de Economia Mista atividade_principal: codigo: '0600001' descricao: Extração de petróleo e gás natural atividades_secundarias: - codigo: '1921700' descricao: Fabricação de produtos do refino de petróleo - codigo: '3520401' descricao: Produção de gás; processamento de gás natural endereco: logradouro: Avenida Republica do Chile numero: '65' complemento: null bairro: Centro cidade: Rio de Janeiro uf: RJ cep: '20031170' telefones: - ddi: '55' ddd: '21' numero: '21660000' numero_completo: '552121660000' estado: RJ operadora: Fixo emails: - email: cc-rfisc@petrobras.com.br dominio: petrobras.com.br corporativo: true socios: - nome: Claudio Romeo Schlosser documento: 406.077.120-15 tipo_documento: CPF tipo: Pessoa Física qualificacao: Diretor data_entrada: '2023-04-17' data_nascimento: '1964-04-15' sexo: Masculino idade: 61 faixa_etaria: Mais de 60 anos situacao_especial: null data_situacao_especial: null '400': description: Parametro invalido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Token ausente ou invalido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: EmpresaResponse: type: object properties: documento: type: string description: CNPJ formatado tipo_documento: type: string enum: - CNPJ cnpj_basico: type: string description: CNPJ raiz (8 dígitos) razao_social: type: string nome_fantasia: type: string nullable: true situacao: type: string description: Ativa, Baixada, Inapta, Suspensa, Nula data_situacao: type: string description: Data ISO da situação cadastral motivo_situacao: type: string nullable: true data_abertura: type: string description: Data ISO de início das atividades capital_social: type: number porte: type: string nullable: true description: Micro empresa, Empresa de pequeno porte, Médio ou Grande porte matriz_filial: type: string nullable: true description: Matriz ou Filial natureza_juridica: type: object properties: codigo: type: string description: Código numérico da natureza jurídica descricao: type: string atividade_principal: type: object nullable: true properties: codigo: type: string description: Código CNAE descricao: type: string atividades_secundarias: type: array items: type: object properties: codigo: type: string descricao: type: string endereco: type: object properties: logradouro: type: string numero: type: string complemento: type: string nullable: true bairro: type: string cidade: type: string uf: type: string cep: type: string telefones: type: array items: type: object properties: ddi: type: string ddd: type: string numero: type: string numero_completo: type: string estado: type: string operadora: type: string emails: type: array items: type: object properties: email: type: string dominio: type: string corporativo: type: boolean socios: type: array items: type: object properties: nome: type: string documento: type: string nullable: true description: >- CPF ou CNPJ formatado. Null quando o CPF do sócio está mascarado e não pôde ser resolvido tipo_documento: type: string description: CPF ou CNPJ tipo: type: string description: Pessoa Física ou Pessoa Jurídica qualificacao: type: string data_entrada: type: string pais: type: string description: País do sócio (padrão Brasil) origem: type: string description: 'Fonte do vínculo societário (ex: qsa)' data_nascimento: type: string nullable: true description: Somente Pessoa Física sexo: type: string nullable: true description: Somente Pessoa Física idade: type: integer nullable: true description: Somente Pessoa Física faixa_etaria: type: string nullable: true description: Somente Pessoa Física representante: type: object nullable: true description: Representante legal — somente Pessoa Jurídica properties: nome: type: string documento: type: string nullable: true qualificacao: type: string situacao_especial: type: string nullable: true data_situacao_especial: type: string nullable: true ErrorResponse: type: object properties: success: type: boolean example: false erro: type: object properties: codigo: type: string description: 'Codigo do erro (ex: VALIDATION_ERROR, NOT_FOUND, UNAUTHORIZED)' example: VALIDATION_ERROR mensagem: type: string description: Mensagem descritiva do erro example: CPF invalido securitySchemes: tokenAuth: type: apiKey in: query name: token ````