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

# Imoveis urbanos de uma empresa

> Retorna as propriedades urbanas registradas em nome do CNPJ. Nao inclui parentes nem enderecos resididos. CNPJ invalido retorna HTTP 200 com corpo { "erro": "CNPJ invalido" }.



## OpenAPI

````yaml /openapi/imoveis.json get /imoveis/cnpj/{cnpj}
openapi: 3.0.0
info:
  title: Sherlocker Imoveis API
  description: >-
    Levantamento de imoveis urbanos via base unificada de portais IPTU de 1.400+
    municipios. Busca por CPF ou CNPJ do proprietario.
  version: '1.0'
servers:
  - url: https://221b-api.sherlocker.com.br/api/v1
security:
  - tokenAuth: []
paths:
  /imoveis/cnpj/{cnpj}:
    get:
      tags:
        - Imoveis
      summary: Imoveis urbanos de uma empresa
      description: >-
        Retorna as propriedades urbanas registradas em nome do CNPJ. Nao inclui
        parentes nem enderecos resididos. CNPJ invalido retorna HTTP 200 com
        corpo { "erro": "CNPJ invalido" }.
      operationId: getImoveisByCnpj
      parameters:
        - name: cnpj
          in: path
          required: true
          description: CNPJ (14 digitos, com ou sem mascara)
          schema:
            type: string
            example: '12345678000199'
      responses:
        '200':
          description: Imoveis encontrados (ou corpo { erro } quando o CNPJ e invalido)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImoveisCnpjResponse'
              example:
                documento: 12.345.678/0001-99
                tipo_documento: CNPJ
                propriedades:
                  - id: sp-cn-045012-00321
                    fonte: elotech
                    sql_iptu: 045.012.0032-1
                    inscricao: 045.012.0032-1
                    localizacao:
                      logradouro: Rua Exemplo
                      numero: '123'
                      complemento: Sala 10
                      bairro: Centro
                      cidade: São Paulo
                      uf: SP
                      cep: '01310100'
                    area_terreno: 400
                    area_construida: 280
                    ano_construcao: 2010
                    tipo_uso: Comercial
                    valor_venal: 1200000
                    valor_iptu: 8500
                    proprietario:
                      nome: Silva Comércio Ltda
                      documento: 12.345.678/0001-99
                      tipoDocumento: CNPJ
        '401':
          description: Token ausente ou invalido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ImoveisCnpjResponse:
      type: object
      description: >-
        Resposta de /imoveis/cnpj/{cnpj}. NAO inclui nome, parentes nem
        enderecos_resididos; itens de propriedades sao ImovelRecord puro (sem
        tipo_propriedade/quantidade).
      properties:
        documento:
          type: string
          description: CNPJ formatado 00.000.000/0000-00
        tipo_documento:
          type: string
          enum:
            - CNPJ
        propriedades:
          type: array
          items:
            $ref: '#/components/schemas/ImovelRecord'
    ErrorResponse:
      type: object
      description: 'Envelope de erro para excecoes lancadas (ex: 401/500).'
      properties:
        statusCode:
          type: integer
          example: 401
        message:
          type: string
          example: Unauthorized
        path:
          type: string
          example: /api/v1/imoveis/cpf/12345678901
        timestamp:
          type: string
          format: date-time
    ImovelRecord:
      type: object
      properties:
        id:
          type: string
        fonte:
          type: string
          description: 'Plataforma/origem do dado IPTU municipal (ex: betha, elotech, sia)'
        sql_iptu:
          type: string
        inscricao:
          type: string
          description: Inscricao municipal
        localizacao:
          $ref: '#/components/schemas/Localizacao'
        area_terreno:
          type: number
          description: Area do terreno em m2
        area_construida:
          type: number
          description: Area construida em m2
        ano_construcao:
          type: integer
        tipo_uso:
          type: string
          description: Residencial, comercial, etc
        valor_venal:
          type: number
          description: Valor venal em reais
        valor_iptu:
          type: number
          description: IPTU anual em reais
        proprietario:
          $ref: '#/components/schemas/Proprietario'
    Localizacao:
      type: object
      description: >-
        Endereco completo do imovel (logradouro/bairro/cidade vem em Title
        Case).
      properties:
        logradouro:
          type: string
        numero:
          type: string
        complemento:
          type: string
        bairro:
          type: string
        cidade:
          type: string
        uf:
          type: string
        cep:
          type: string
    Proprietario:
      type: object
      description: >-
        Proprietario do imovel. documento vem formatado (CPF 000.000.000-00 /
        CNPJ 00.000.000/0000-00) ou null. ATENCAO: a chave do tipo e
        tipoDocumento (camelCase).
      properties:
        nome:
          type: string
        documento:
          type: string
          nullable: true
          description: CPF/CNPJ formatado, ou null quando ausente
        tipoDocumento:
          type: string
          enum:
            - CPF
            - CNPJ
          description: Pode estar ausente quando o documento nao tem 11/14 digitos
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: query
      name: token

````