> ## 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 Cadastral por CPF

> Agrega em uma chamada: identidade, enderecos, telefones, emails, parentes, empresas e empregos.



## OpenAPI

````yaml /openapi/perfil.json get /perfil/cadastral/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/cadastral/cpf/{cpf}:
    get:
      tags:
        - Perfil Cadastral
      summary: Perfil Cadastral por CPF
      description: >-
        Agrega em uma chamada: identidade, enderecos, telefones, emails,
        parentes, empresas e empregos.
      operationId: perfilCadastralCpf
      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 cadastral completo da pessoa fisica. Observacao: para
            documento invalido ou nao encontrado a API responde 200 com o corpo
            { "erro": "..." } (ex.: CPF invalido, CPF nao encontrado, Servico
            indisponivel).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PerfilCadastralCpfResponse'
              example:
                documento: 123.456.789-01
                tipo_documento: CPF
                nome_completo: Maria Silva Santos
                genero: Feminino
                data_nascimento: '1996-01-02'
                falecido: false
                obito: null
                enderecos:
                  - logradouro: R HENRIQUE PASSINI
                    numero: '748'
                    complemento: '401'
                    bairro: SERRA
                    cidade: BELO HORIZONTE
                    uf: MG
                    cep: 30220-380
                telefones:
                  - ddi: '55'
                    ddd: '31'
                    numero: '987654321'
                    numero_completo: '5531987654321'
                    estado: MG
                    operadora: Vivo
                    data: '2022-01-01'
                emails:
                  - email: maria@gmail.com
                    dominio: gmail.com
                    corporativo: false
                parentes:
                  - nome: João da Silva
                    documento: 987.654.321-00
                    tipo_documento: CPF
                    vinculo_codigo: '03'
                    vinculo_nome: Pai
                empresas:
                  - documento: 12.345.678/0001-95
                    tipo_documento: CNPJ
                    razao_social: Empresa Ltda
                    nome_fantasia: Empresa
                empregos:
                  - documento_empregador: 12.345.678/0001-95
                    tipo_documento_empregador: CNPJ
                    nome_empregador: Empresa Ltda
                    cargo: ANALISTA
                    status: ativo
                    data_admissao: '2020-03-15'
                    data_desligamento: null
                    remuneracao:
                      valor: 4500
                      estimativa_minima: 5060
                      estimativa_maxima: 12650
                      faixa: 4 a 10 SM
                    vinculo:
                      nivel: Funcionário
                      setor:
                        tipo: Privado
                        codigo: '6209100'
                        descricao: Suporte tecnico em TI
                    contatos:
                      telefone:
                        ddi: '55'
                        ddd: '31'
                        numero: '987654321'
                        numero_completo: '5531987654321'
                        estado: MG
                        operadora: Vivo
                      email:
                        email: maria@empresa.com.br
                        dominio: empresa.com.br
                        corporativo: true
                publicamente_exposta: false
                cargos_publicos: []
                beneficios:
                  auxilio_brasil: []
                  bolsa_familia: []
                  auxilio_emergencial: []
                  bpc: []
                dominios: []
        '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:
    PerfilCadastralCpfResponse:
      type: object
      description: Perfil cadastral completo de uma pessoa fisica
      properties:
        documento:
          type: string
          description: CPF formatado (000.000.000-00)
          example: 123.456.789-01
        tipo_documento:
          type: string
          enum:
            - CPF
          example: CPF
        nome_completo:
          type: string
          description: Nome completo da pessoa
          example: Maria Silva Santos
        genero:
          type: string
          description: Genero da pessoa (Masculino, Feminino, Intersexo ou string vazia)
          example: Feminino
        data_nascimento:
          type: string
          description: Data de nascimento no formato YYYY-MM-DD
          example: '1996-01-02'
        falecido:
          type: boolean
          description: Indica se ha registro de obito para a pessoa
          example: false
        obito:
          type: object
          nullable: true
          description: Dados do obito (null quando nao falecido)
          properties:
            data_obito:
              type: string
              description: Data do obito no formato YYYY-MM-DD
              example: '2023-04-10'
            cartorio:
              type: string
              description: Nome do cartorio de registro
              example: Cartorio Central
        enderecos:
          type: array
          description: Lista de enderecos associados a pessoa
          items:
            $ref: '#/components/schemas/Endereco'
        telefones:
          type: array
          description: Lista de telefones associados a pessoa
          items:
            $ref: '#/components/schemas/Telefone'
        emails:
          type: array
          description: Lista de emails associados a pessoa
          items:
            $ref: '#/components/schemas/Email'
        parentes:
          type: array
          description: Lista de parentes identificados
          items:
            $ref: '#/components/schemas/Parente'
        publicamente_exposta:
          type: boolean
          description: Indica se a pessoa e politicamente exposta (PEP)
          example: false
        cargos_publicos:
          type: array
          description: Cargos publicos/mandatos consolidados (vazio quando nao PEP)
          items:
            $ref: '#/components/schemas/CargoPublico'
        empresas:
          type: array
          description: Empresas em que a pessoa e socia ou responsavel
          items:
            $ref: '#/components/schemas/EmpresaVinculada'
        empregos:
          type: array
          description: Vinculos empregaticos da pessoa
          items:
            $ref: '#/components/schemas/Emprego'
        beneficios:
          $ref: '#/components/schemas/BeneficiosCpf'
        dominios:
          type: array
          description: Dominios de internet associados aos emails da pessoa
          items:
            $ref: '#/components/schemas/Dominio'
    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
    Endereco:
      type: object
      description: Endereco completo
      properties:
        logradouro:
          type: string
          description: Nome da rua, avenida ou logradouro
          example: R HENRIQUE PASSINI
        numero:
          type: string
          description: Numero do imovel
          example: '748'
        complemento:
          type: string
          description: Complemento do endereco (apartamento, sala, etc.)
          example: '401'
        bairro:
          type: string
          description: Nome do bairro
          example: SERRA
        cidade:
          type: string
          description: Nome da cidade
          example: BELO HORIZONTE
        uf:
          type: string
          description: Sigla da unidade federativa (estado)
          example: MG
        cep:
          type: string
          description: CEP no formato 00000-000
          example: 30220-380
    Telefone:
      type: object
      description: Informacoes de telefone com detalhes da operadora
      properties:
        ddi:
          type: string
          description: Codigo DDI do pais
          example: '55'
        ddd:
          type: string
          description: Codigo DDD da regiao
          example: '31'
        numero:
          type: string
          description: Numero do telefone sem DDD
          example: '987654321'
        numero_completo:
          type: string
          description: Numero completo com DDI + DDD + numero
          example: '5531987654321'
        estado:
          type: string
          description: UF associada ao DDD
          example: MG
        operadora:
          type: string
          description: Nome da operadora de telefonia
          example: Vivo
        data:
          type: string
          nullable: true
          description: >-
            Ano de referencia do registro do telefone no formato YYYY-01-01
            (sempre 1o de janeiro do ano derivado), ou null. Presente apenas nos
            telefones de pessoa fisica (telefones de empresa e de contatos de
            emprego nao incluem este campo).
          example: '2022-01-01'
    Email:
      type: object
      description: Endereco de email com classificacao
      properties:
        email:
          type: string
          description: Endereco de email completo
          example: maria@gmail.com
        dominio:
          type: string
          description: Dominio do email
          example: gmail.com
        corporativo:
          type: boolean
          description: Indica se o email e corporativo (dominio proprio)
          example: false
    Parente:
      type: object
      description: Vinculo familiar da pessoa
      properties:
        nome:
          type: string
          description: Nome completo do parente
          example: JOAO DA SILVA
        documento:
          type: string
          description: >-
            CPF formatado do parente (000.000.000-00), ou string vazia quando
            indisponivel
          example: 987.654.321-00
        tipo_documento:
          type: string
          enum:
            - CPF
          example: CPF
        vinculo_codigo:
          type: string
          description: 'Codigo do vinculo familiar (ex: 01)'
          example: '01'
        vinculo_nome:
          type: string
          description: Descricao do vinculo (Conjuge, Pai, Mae, Filho, etc.)
          example: Pai
    CargoPublico:
      type: object
      description: Cargo publico/mandato consolidado de uma pessoa politicamente exposta
      properties:
        cargo:
          type: string
          description: Descricao do cargo/funcao
          example: Deputado Federal
        nivel:
          type: string
          nullable: true
          description: Nivel da funcao (null se indisponivel)
          example: Federal
        orgao:
          type: string
          description: Orgao (sem o sufixo de UF)
          example: Camara Dos Deputados
        uf:
          type: string
          description: UF extraida do nome do orgao (vazio se ausente)
          example: SP
        mandatos:
          type: array
          description: Periodos de mandato consolidados para o mesmo cargo/orgao
          items:
            type: object
            properties:
              inicio:
                type: string
                nullable: true
                description: Data de inicio (ISO YYYY-MM-DD) ou null
              fim:
                type: string
                nullable: true
                description: Data de fim (ISO YYYY-MM-DD) ou null
              carencia_ate:
                type: string
                nullable: true
                description: Fim do periodo de carencia (ISO YYYY-MM-DD) ou null
    EmpresaVinculada:
      type: object
      description: Empresa vinculada a pessoa fisica (como socio ou responsavel)
      properties:
        documento:
          type: string
          description: CNPJ formatado da empresa (00.000.000/0000-00)
          example: 12.345.678/0001-95
        tipo_documento:
          type: string
          enum:
            - CNPJ
          example: CNPJ
        razao_social:
          type: string
          description: Razao social da empresa
          example: EMPRESA LTDA
        nome_fantasia:
          type: string
          description: Nome fantasia da empresa
          example: EMPRESA
    Emprego:
      type: object
      description: Vinculo empregaticio da pessoa fisica
      properties:
        documento_empregador:
          type: string
          description: CNPJ formatado do empregador (00.000.000/0000-00)
          example: 12.345.678/0001-95
        tipo_documento_empregador:
          type: string
          enum:
            - CNPJ
          example: CNPJ
        nome_empregador:
          type: string
          description: Razao social do empregador
          example: Silva Comercio LTDA
        cargo:
          type: string
          nullable: true
          description: Cargo ou funcao exercida (null se indisponivel)
          example: Gerente Comercial
        status:
          type: string
          description: ativo ou inativo
        data_admissao:
          type: string
          nullable: true
          description: Data de admissao no formato YYYY-MM-DD (null se indisponivel)
          example: '2019-01-15'
        data_desligamento:
          type: string
          nullable: true
          description: Data de desligamento (null se ainda empregado)
        remuneracao:
          type: object
          nullable: true
          properties:
            valor:
              type: number
              nullable: true
            estimativa_minima:
              type: number
              nullable: true
            estimativa_maxima:
              type: number
              nullable: true
            faixa:
              type: string
              nullable: true
        vinculo:
          type: object
          nullable: true
          properties:
            nivel:
              type: string
              nullable: true
            setor:
              type: object
              nullable: true
              properties:
                tipo:
                  type: string
                  nullable: true
                codigo:
                  type: string
                  nullable: true
                descricao:
                  type: string
                  nullable: true
        contatos:
          type: object
          nullable: true
          properties:
            telefone:
              $ref: '#/components/schemas/Telefone'
            email:
              $ref: '#/components/schemas/Email'
    BeneficiosCpf:
      type: object
      description: Beneficios sociais recebidos pela pessoa fisica
      properties:
        auxilio_brasil:
          type: array
          description: Pagamentos do programa Auxilio Brasil
          items:
            type: object
        bolsa_familia:
          type: array
          description: Pagamentos do programa Bolsa Familia
          items:
            type: object
        auxilio_emergencial:
          type: array
          description: Pagamentos do Auxilio Emergencial
          items:
            type: object
        bpc:
          type: array
          description: Pagamentos do Beneficio de Prestacao Continuada (BPC/LOAS)
          items:
            type: object
    Dominio:
      type: object
      description: Dominio de internet associado a um email da pessoa
      properties:
        dominio:
          type: string
          example: exemplo.com.br
        registrado:
          type: boolean
          example: true
        data_criacao:
          type: string
          nullable: true
        data_atualizacao:
          type: string
          nullable: true
        data_expiracao:
          type: string
          nullable: true
        registrador:
          type: object
          nullable: true
          properties:
            nome:
              type: string
              nullable: true
            url:
              type: string
              nullable: true
        registrante:
          type: object
          nullable: true
          properties:
            nome:
              type: string
              nullable: true
            empresa:
              type: string
              nullable: true
            email:
              type: string
              nullable: true
            telefone:
              type: string
              nullable: true
            pais:
              type: string
              nullable: true
        email_origem:
          type: string
          description: Email a partir do qual o dominio foi derivado
          example: maria@exemplo.com.br
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: query
      name: token

````