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

# Informações básicas

> Retorna informações básicas da empresa: dados cadastrais, situação na Receita Federal, natureza jurídica, atividades (CNAEs), endereço, telefones, emails e quadro societário.



## OpenAPI

````yaml /openapi/empresas.json get /empresas/cnpj/{cnpj}
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/cnpj/{cnpj}:
    get:
      tags:
        - Empresas
      summary: Informações básicas
      description: >-
        Retorna informações básicas da empresa: dados cadastrais, situação na
        Receita Federal, natureza jurídica, atividades (CNAEs), endereço,
        telefones, emails e quadro societário.
      operationId: getEmpresaByCnpj
      parameters:
        - name: cnpj
          in: path
          required: true
          description: CNPJ da empresa (14 digitos)
          schema:
            type: string
            example: '12345678000199'
      responses:
        '200':
          description: Perfil completo da empresa com todos os dados agregados
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmpresaResponse'
              example:
                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édio 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'
                    pais: Brasil
                    origem: qsa
                    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

````