> ## 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.

# Identificar empresas por email

> Busca reversa: identifica empresas que possuem o email informado no cadastro da Receita Federal. Retorna o perfil completo de cada empresa. O array `socios` nao e populado neste endpoint (use /empresas/cnpj/{cnpj} ou /empresas/cpf/{cpf} para o quadro societario).



## OpenAPI

````yaml /openapi/empresas.json get /empresas/email/{email}
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/email/{email}:
    get:
      tags:
        - Busca Reversa
      summary: Identificar empresas por email
      description: >-
        Busca reversa: identifica empresas que possuem o email informado no
        cadastro da Receita Federal. Retorna o perfil completo de cada empresa.
        O array `socios` nao e populado neste endpoint (use
        /empresas/cnpj/{cnpj} ou /empresas/cpf/{cpf} para o quadro societario).
      operationId: getEmpresasByEmail
      parameters:
        - name: email
          in: path
          required: true
          description: Email cadastrado na empresa
          schema:
            type: string
            example: contato@empresa.com.br
        - 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: Empresas encontradas (perfil completo, `socios` vazio)
          content:
            application/json:
              schema:
                type: object
                properties:
                  empresas:
                    type: array
                    items:
                      $ref: '#/components/schemas/EmpresaResponse'
              example:
                empresas:
                  - documento: 12.345.678/0001-99
                    tipo_documento: CNPJ
                    cnpj_basico: '12345678'
                    razao_social: Empresa Exemplo Ltda
                    nome_fantasia: Exemplo
                    situacao: Ativa
                    data_situacao: '2010-05-20'
                    capital_social: 100000
                    porte: Empresa de Pequeno Porte
                    matriz_filial: Matriz
                    natureza_juridica:
                      codigo: '2062'
                      descricao: Sociedade Empresária Limitada
                    atividade_principal:
                      codigo: '4729199'
                      descricao: Comércio varejista de outros produtos
                    atividades_secundarias: []
                    endereco:
                      logradouro: Rua Exemplo
                      numero: '100'
                      complemento: null
                      bairro: Centro
                      cidade: São Paulo
                      uf: SP
                      cep: '01000000'
                    telefones:
                      - ddi: '55'
                        ddd: '11'
                        numero: '33334444'
                        numero_completo: '551133334444'
                        estado: SP
                        operadora: Fixo
                    emails:
                      - email: contato@empresa.com.br
                        dominio: empresa.com.br
                        corporativo: true
                    socios: []
                    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

````