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

# Perfil Patrimonial por CPF

> Agrega em uma chamada: veiculos, imoveis, aeronaves, patentes e perfil rural.



## OpenAPI

````yaml /openapi/perfil.json get /perfil/patrimonial/cpf/{cpf}
openapi: 3.0.0
info:
  title: Sherlocker Perfis Agregados
  description: >-
    Endpoints de perfil que agregam dados de multiplas fontes em uma unica
    chamada.
  version: '1.0'
servers:
  - url: https://221b-api.sherlocker.com.br/api/v1
security:
  - tokenAuth: []
tags:
  - name: Perfil Cadastral
    description: Dados cadastrais agregados de pessoas fisicas e juridicas
  - name: Perfil Patrimonial
    description: >-
      Patrimonio agregado: veiculos, imoveis, aeronaves, patentes e propriedades
      rurais
  - name: Perfil Juridico
    description: Processos judiciais, trabalhistas e compliance
  - name: Perfil Financeiro
    description: Dividas federais, beneficios sociais e renuncias fiscais
paths:
  /perfil/patrimonial/cpf/{cpf}:
    get:
      tags:
        - Perfil Patrimonial
      summary: Perfil Patrimonial por CPF
      description: >-
        Agrega em uma chamada: veiculos, imoveis, aeronaves, patentes e perfil
        rural.
      operationId: perfilPatrimonialCpf
      parameters:
        - name: cpf
          in: path
          required: true
          description: CPF da pessoa fisica (somente digitos, 11 caracteres)
          schema:
            type: string
            example: '12345678901'
      responses:
        '200':
          description: >-
            Perfil patrimonial completo da pessoa fisica. Observacao: para CPF
            invalido a API responde 200 com o corpo { "erro": "CPF invalido" }.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PerfilPatrimonialResponse'
              example:
                veiculos:
                  - documento: '12345678901'
                    tipo: PF
                    nome_proprietario: MARIA DA SILVA
                    ano_documento: 2022
                    placa: ABC1D23
                    placa_antiga: ABC1234
                    placa_nova: ABC1D23
                    renavam: '12345678901'
                    chassi: 9BWAG45N1YT123456
                    ano_fabricacao: 2019
                    ano_modelo: 2020
                    marca: VW
                    modelo: GOL 1.0
                    cor: Prata
                    combustivel: Flex
                    tipo_veiculo: Automovel
                    especie_veiculo: Passageiro
                    potencia: '75'
                    cilindradas: '999'
                    quantidade_passageiro: '5'
                    municipio: SAO PAULO
                    uf: SP
                    situacao_veiculo: Circulacao
                    restricao_1: ''
                    restricao_2: ''
                    restricao_3: ''
                    restricao_4: ''
                    nacionalidade: ''
                    carroceria: ''
                    tipo_montagem: ''
                    peso_bruto_total: ''
                    cap_maxima_tracao: ''
                    capacidade_carga: ''
                    motor: ''
                    caixa_cambio: ''
                    situacao_chassi: ''
                    eixos: ''
                    media_preco: ''
                    updated_at: 0
                imoveis:
                  - id: a1b2c3
                    fonte: bh
                    sql_iptu: '0123456789'
                    inscricao: '0123456789'
                    localizacao:
                      logradouro: R EXEMPLO
                      numero: '100'
                      complemento: ''
                      bairro: CENTRO
                      cidade: BELO HORIZONTE
                      uf: MG
                      cep: 30130-000
                    area_terreno: 360
                    area_construida: 180
                    ano_construcao: 1995
                    tipo_uso: RESIDENCIAL
                    valor_venal: 450000
                    valor_iptu: 2400
                    proprietario:
                      nome: MARIA DA SILVA
                      documento: '12345678901'
                      tipoDocumento: CPF
                aeronaves:
                  avioes: []
                  drones: []
                patentes:
                  - numero_inpi: BR102020012345
                    codigo_interno: ''
                    depositante: MARIA DA SILVA
                    cgccpfdepositante: '12345678901'
                    tipopessoadepositante: Fisica
                    pais: BR
                    estado: SP
                    data_inicio_depositante: ''
                    data_fim_depositante: ''
                    titulo: DISPOSITIVO PARA FILTRAGEM
                    resumo: ''
                    natureza: PATENTE DE INVENCAO
                    data_deposito: '2020-06-15'
                    data_publicacao: '2021-12-21'
                    data_concessao: ''
                    classificacao_ipc: ''
                    despacho_codigo: ''
                    despacho_texto: ''
                    despacho_data_rpi: ''
                    inventores: ''
                    procuradores: ''
                rural: 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:
    PerfilPatrimonialResponse:
      type: object
      description: Perfil patrimonial completo com todos os bens identificados
      properties:
        veiculos:
          type: array
          description: Lista de veiculos registrados
          items:
            $ref: '#/components/schemas/Veiculo'
        imoveis:
          type: array
          description: Lista de imoveis identificados via IPTU
          items:
            $ref: '#/components/schemas/Imovel'
        aeronaves:
          $ref: '#/components/schemas/Aeronaves'
        patentes:
          type: array
          description: Lista de patentes e registros de propriedade intelectual
          items:
            $ref: '#/components/schemas/Patente'
        rural:
          type: object
          nullable: true
          description: >-
            Dados rurais. ATENCAO: o formato difere por tipo de documento. Para
            CPF (perfilCompleto): objeto rico { documento, tipo,
            propriedades_sncr[], propriedades_cafir[], transportes{ total,
            volume_total, valor_total, produtos[], por_produto[], por_ano[],
            parceiros[] }, autorizacoes[], infracoes[], produtor_organico[],
            resumo{ area_total_ha, qtd_imoveis_sncr, qtd_imoveis_cafir,
            qtd_infracoes, valor_total_multas, qtd_autorizacoes,
            qtd_transportes, estados[] } }. Para CNPJ (findByCpfCnpj): objeto {
            imoveisRurais: SncrRow[], perfil: objeto | null }. Em ambos os casos
            retorna null se a consulta exceder o timeout (5s) ou falhar.
          properties:
            documento:
              type: string
              description: '[CPF] Documento consultado'
            tipo:
              type: string
              enum:
                - PF
                - PJ
              description: '[CPF] Tipo de pessoa'
            propriedades_sncr:
              type: array
              description: '[CPF] Imoveis no SNCR/INCRA'
              items:
                type: object
            propriedades_cafir:
              type: array
              description: '[CPF] Imoveis no CAFIR'
              items:
                type: object
            transportes:
              type: object
              description: '[CPF] Resumo de transportes de produtos rurais'
            autorizacoes:
              type: array
              description: '[CPF] Autorizacoes (AUTEX) agrupadas'
              items:
                type: object
            infracoes:
              type: array
              description: '[CPF] Fiscalizacoes/infracoes ambientais'
              items:
                type: object
            produtor_organico:
              type: array
              description: '[CPF] Registros de produtor organico'
              items:
                type: object
            resumo:
              type: object
              description: '[CPF] Totalizadores rurais'
            imoveisRurais:
              type: array
              description: >-
                [CNPJ] Imoveis rurais (SncrRow). Observe o nome de campo em
                camelCase.
              items:
                type: object
            perfil:
              type: object
              nullable: true
              description: '[CNPJ] Perfil rural consolidado, ou null'
    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
    Veiculo:
      type: object
      description: >-
        Veiculo registrado em nome da pessoa ou empresa (linha bruta da base,
        sem normalizacao de marca/modelo)
      properties:
        documento:
          type: string
          description: CPF/CNPJ do proprietario (somente digitos)
          example: '12345678901'
        tipo:
          type: string
          enum:
            - PF
            - PJ
          description: Tipo de pessoa do proprietario
          example: PF
        nome_proprietario:
          type: string
          description: Nome do proprietario do veiculo
          example: MARIA DA SILVA
        ano_documento:
          type: integer
          description: Ano de referencia do registro de propriedade
          example: 2022
        placa:
          type: string
          description: Placa atual do veiculo
          example: ABC1D23
        placa_antiga:
          type: string
          description: Placa formato antigo (ABC-1234)
          example: ABC1234
        placa_nova:
          type: string
          description: Placa modelo Mercosul
          example: ABC1D23
        renavam:
          type: string
          description: Codigo RENAVAM
          example: '12345678901'
        chassi:
          type: string
          description: Numero do chassi
          example: 9BWAG45N1YT123456
        ano_fabricacao:
          type: integer
          description: Ano de fabricacao
          example: 2021
        ano_modelo:
          type: integer
          description: Ano do modelo
          example: 2022
        marca:
          type: string
          description: Marca do fabricante (extraida da parte antes da barra em modelo)
          example: FIAT
        modelo:
          type: string
          description: Modelo do veiculo
          example: STRADA TREK CE
        cor:
          type: string
          description: Cor predominante do veiculo
          example: Prata
        combustivel:
          type: string
          description: Tipo de combustivel
          example: Flex
        tipo_veiculo:
          type: string
          description: Tipo do veiculo (Automovel, Motocicleta, Caminhao, etc.)
          example: Automovel
        especie_veiculo:
          type: string
          description: Especie do veiculo (codigo ou descricao crua da base)
          example: Passageiro
        potencia:
          type: string
          description: Potencia do motor
          example: '130'
        cilindradas:
          type: string
          description: Cilindradas do motor
          example: '1300'
        quantidade_passageiro:
          type: string
          description: Quantidade de passageiros
          example: '5'
        municipio:
          type: string
          description: Municipio de registro do veiculo
          example: SAO PAULO
        uf:
          type: string
          description: UF de registro do veiculo
          example: SP
        situacao_veiculo:
          type: string
          description: Situacao atual do veiculo (codigo ou descricao crua da base)
          example: Circulacao
        restricao_1:
          type: string
          description: Restricao 1 do veiculo (string vazia se nenhuma)
          example: Alienacao Fiduciaria
        restricao_2:
          type: string
          description: Restricao 2 do veiculo (string vazia se nenhuma)
          example: ''
        restricao_3:
          type: string
          description: Restricao 3 do veiculo (string vazia se nenhuma)
          example: ''
        restricao_4:
          type: string
          description: Restricao 4 do veiculo (string vazia se nenhuma)
          example: ''
        nacionalidade:
          type: string
          description: Nacionalidade do veiculo
          example: ''
        carroceria:
          type: string
          description: Tipo de carroceria
          example: ''
        tipo_montagem:
          type: string
          description: Tipo de montagem
          example: ''
        peso_bruto_total:
          type: string
          description: Peso bruto total
          example: ''
        cap_maxima_tracao:
          type: string
          description: Capacidade maxima de tracao
          example: ''
        capacidade_carga:
          type: string
          description: Capacidade de carga
          example: ''
        motor:
          type: string
          description: Numero/identificacao do motor
          example: ''
        caixa_cambio:
          type: string
          description: Identificacao da caixa de cambio
          example: ''
        situacao_chassi:
          type: string
          description: Situacao do chassi
          example: ''
        eixos:
          type: string
          description: Quantidade de eixos
          example: ''
        media_preco:
          type: string
          description: Media de preco estimada (string)
          example: ''
        updated_at:
          type: integer
          description: Timestamp interno de atualizacao (retorna 0 nesta consulta)
          example: 0
    Imovel:
      type: object
      description: Imovel registrado em nome da pessoa ou empresa
      properties:
        id:
          type: string
          description: Identificador unico interno do imovel
          example: a1b2c3
        fonte:
          type: string
          description: Fonte dos dados do imovel (codigo da cidade)
          example: bh
        sql_iptu:
          type: string
          description: Numero SQL/IPTU do imovel
          example: '0123456789'
        inscricao:
          type: string
          description: Numero da inscricao imobiliaria municipal
          example: '0123456789'
        localizacao:
          $ref: '#/components/schemas/LocalizacaoImovel'
        area_terreno:
          type: number
          description: Area do terreno em metros quadrados
          example: 360
        area_construida:
          type: number
          description: Area construida em metros quadrados
          example: 180
        ano_construcao:
          type: integer
          description: Ano de construcao do imovel
          example: 1995
        tipo_uso:
          type: string
          description: Tipo de uso do imovel (RESIDENCIAL, COMERCIAL, INDUSTRIAL, etc.)
          example: RESIDENCIAL
        valor_venal:
          type: number
          description: Valor venal do imovel em reais
          example: 450000
        valor_iptu:
          type: number
          description: Valor anual do IPTU em reais
          example: 2400
        proprietario:
          type: object
          description: >-
            Proprietario do imovel. ATENCAO: o campo do tipo de documento usa
            camelCase (tipoDocumento), diferente do padrao snake_case do
            restante da API.
          properties:
            nome:
              type: string
              description: Nome do proprietario (string vazia se indisponivel)
              example: MARIA DA SILVA
            documento:
              type: string
              nullable: true
              description: CPF/CNPJ do proprietario (somente digitos), ou null
              example: '12345678901'
            tipoDocumento:
              type: string
              enum:
                - CPF
                - CNPJ
              description: >-
                Tipo do documento. Ausente quando o documento e vazio/invalido
                (campo opcional, camelCase).
              example: CPF
    Aeronaves:
      type: object
      description: Aeronaves registradas (avioes e drones/RPAS)
      properties:
        avioes:
          type: array
          description: Lista de avioes registrados
          items:
            $ref: '#/components/schemas/Aeronave'
        drones:
          type: array
          description: Lista de drones/RPAS registrados
          items:
            $ref: '#/components/schemas/Drone'
    Patente:
      type: object
      description: >-
        Patente ou registro de propriedade intelectual no INPI (linha bruta da
        base; datas no formato armazenado, nao necessariamente ISO)
      properties:
        numero_inpi:
          type: string
          description: Numero do registro no INPI
          example: BR102020012345
        codigo_interno:
          type: string
          description: Codigo interno do registro
          example: ''
        depositante:
          type: string
          description: Nome do depositante
          example: MARIA DA SILVA
        cgccpfdepositante:
          type: string
          description: CPF/CNPJ do depositante
          example: '12345678901'
        tipopessoadepositante:
          type: string
          description: Tipo de pessoa do depositante
          example: Fisica
        pais:
          type: string
          example: BR
        estado:
          type: string
          example: SP
        data_inicio_depositante:
          type: string
          example: ''
        data_fim_depositante:
          type: string
          example: ''
        titulo:
          type: string
          description: Titulo da patente ou invencao (texto bruto da base)
          example: DISPOSITIVO PARA FILTRAGEM
        resumo:
          type: string
          description: Resumo da patente
          example: ''
        natureza:
          type: string
          description: Natureza da patente (PATENTE DE INVENCAO, MODELO DE UTILIDADE, etc.)
          example: PATENTE DE INVENCAO
        data_deposito:
          type: string
          description: Data de deposito (formato armazenado na base)
          example: '2020-06-15'
        data_publicacao:
          type: string
          description: Data de publicacao (formato armazenado na base)
          example: '2021-12-21'
        data_concessao:
          type: string
          description: Data de concessao (formato armazenado na base)
          example: ''
        classificacao_ipc:
          type: string
          description: Classificacao Internacional de Patentes (IPC)
          example: ''
        despacho_codigo:
          type: string
          example: ''
        despacho_texto:
          type: string
          example: ''
        despacho_data_rpi:
          type: string
          description: Data do despacho na RPI
          example: ''
        inventores:
          type: string
          description: Lista de inventores (texto)
          example: ''
        procuradores:
          type: string
          description: Lista de procuradores (texto)
          example: ''
    LocalizacaoImovel:
      type: object
      description: Localizacao do imovel
      properties:
        logradouro:
          type: string
          description: Nome da rua, avenida ou logradouro
          example: R EXEMPLO
        numero:
          type: string
          description: Numero do imovel
          example: '100'
        complemento:
          type: string
          description: Complemento do endereco
          example: ''
        bairro:
          type: string
          description: Nome do bairro
          example: CENTRO
        cidade:
          type: string
          description: Nome da cidade
          example: BELO HORIZONTE
        uf:
          type: string
          description: Sigla da unidade federativa
          example: MG
        cep:
          type: string
          description: CEP no formato 00000-000
          example: 30130-000
    Aeronave:
      type: object
      description: >-
        Aviao/aeronave tripulada registrada no RAB (linha bruta da base; CPF
        aparece mascarado em cpf_cgc)
      properties:
        documento:
          type: string
          description: CPF/CNPJ do proprietario (somente digitos)
          example: '12345678901'
        tipo:
          type: string
          enum:
            - PF
            - PJ
          example: PF
        marca:
          type: string
          description: Marca de matricula da aeronave
          example: PR-ABC
        proprietario:
          type: string
          description: Nome do proprietario
          example: Maria Da Silva
        outros_proprietarios:
          type: string
          example: ''
        uf:
          type: string
          example: SP
        operador:
          type: string
          example: Maria Da Silva
        outros_operadores:
          type: string
          example: ''
        uf_operador:
          type: string
          example: SP
        cpf_cgc:
          type: string
          description: 'CPF/CNPJ mascarado conforme a base (ex: 123.XXX.XXX-01)'
          example: 123.XXX.XXX-01
        certificado_matricula:
          type: string
          example: ''
        numero_serie:
          type: string
          example: ''
        categoria:
          type: string
          example: ''
        tipo_aeronave:
          type: string
          description: Tipo da aeronave (AVIAO, HELICOPTERO, etc.)
          example: AVIAO
        modelo:
          type: string
          example: ''
        fabricante:
          type: string
          example: ''
        classe:
          type: string
          example: ''
        pmd:
          type: string
          example: ''
        tipo_icao:
          type: string
          example: ''
        tripulacao_minima:
          type: string
          example: ''
        passageiros_maximo:
          type: string
          example: ''
        numero_assentos:
          type: string
          example: ''
        ano_fabricacao:
          type: string
          example: ''
        validade_cva:
          type: string
          example: ''
        validade_ca:
          type: string
          example: ''
        data_cancelamento:
          type: string
          description: Data de cancelamento (normalizada para YYYY-MM-DD quando possivel)
          example: ''
        motivo_cancelamento:
          type: string
          example: ''
        interdicao:
          type: string
          example: ''
        marca_nacional_1:
          type: string
          example: ''
        marca_nacional_2:
          type: string
          example: ''
        marca_nacional_3:
          type: string
          example: ''
        marca_estrangeira:
          type: string
          example: ''
        data_matricula:
          type: string
          description: Data de matricula (normalizada para YYYY-MM-DD quando possivel)
          example: '2019-05-10'
        tipo_motor:
          type: string
          example: ''
        quantidade_motores:
          type: string
          example: ''
        tipo_pouso:
          type: string
          example: ''
        preco_estimado:
          type: number
          description: >-
            Estimativa de preco por categoria (presente apenas quando ha valor
            mapeado para o tipo_aeronave)
          example: 1500000
    Drone:
      type: object
      description: >-
        Drone/RPAS registrado (linha bruta da base; CPF mascarado em
        codigo/operador conforme fonte)
      properties:
        documento:
          type: string
          description: CPF/CNPJ do proprietario (somente digitos)
          example: '12345678901'
        tipo:
          type: string
          enum:
            - PF
            - PJ
          example: PF
        codigo_aeronave:
          type: string
          example: PR-XYZ123
        data_validade:
          type: string
          description: Data de validade (normalizada para YYYY-MM-DD quando possivel)
          example: '2025-12-31'
        operador:
          type: string
          example: Maria Da Silva
        tipo_uso:
          type: string
          description: Tipo de uso (RECREACAO, BASICO, AVANCADO, EXPERIMENTAL, etc.)
          example: RECREACAO
        fabricante:
          type: string
          example: DJI
        modelo:
          type: string
          example: Mavic
        numero_serie:
          type: string
          example: ''
        peso_maximo:
          type: string
          example: ''
        ramo_atividade:
          type: string
          example: ''
        preco_estimado:
          type: number
          description: >-
            Estimativa de preco por tipo de uso (presente apenas quando ha valor
            mapeado)
          example: 3000
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: query
      name: token

````