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

# Informacoes basicas

> Retorna os dados basicos da pessoa: identidade, genero, data de nascimento e parentes.



## OpenAPI

````yaml /openapi/pessoas.json get /pessoas/cpf/{cpf}
openapi: 3.0.0
info:
  title: Sherlocker Pessoas API
  description: >-
    Perfil completo de uma pessoa: identidade, localizacao, contatos, rede
    familiar, beneficios, dividas, patrimonio, processos e historico
    profissional. Ponto de entrada principal para investigacoes a partir de CPF
    ou telefone.
  version: '2.0'
servers:
  - url: https://221b-api.sherlocker.com.br/api/v1
security:
  - tokenAuth: []
paths:
  /pessoas/cpf/{cpf}:
    get:
      tags:
        - Pessoas
      summary: Informacoes basicas
      description: >-
        Retorna os dados basicos da pessoa: identidade, genero, data de
        nascimento e parentes.
      operationId: getPessoaByCpf
      parameters:
        - name: cpf
          in: path
          required: true
          description: CPF (11 digitos, com ou sem formatacao)
          schema:
            type: string
            example: '12345678901'
      responses:
        '200':
          description: Dados basicos da pessoa com parentes
          content:
            application/json:
              schema:
                type: object
                properties:
                  cpf:
                    type: string
                    example: '12345678901'
                  nome_completo:
                    type: string
                    example: João Silva de Oliveira
                  genero:
                    type: string
                    example: Masculino
                  data_nascimento:
                    type: string
                    example: '1990-01-15'
                  falecido:
                    type: boolean
                    description: Indica se a pessoa consta como falecida na base de obitos
                    example: false
                  obito:
                    nullable: true
                    allOf:
                      - $ref: '#/components/schemas/Obito'
                    description: Dados do obito. null se a pessoa nao consta como falecida.
                  parentes:
                    type: array
                    items:
                      type: object
                      properties:
                        nome:
                          type: string
                          example: Maria Silva
                        cpf:
                          type: string
                          example: '98765432100'
                        vinculo_codigo:
                          type: string
                          example: '01'
                        vinculo_nome:
                          type: string
                          example: Cônjuge
              example:
                documento: 123.456.789-01
                tipo_documento: CPF
                nome_completo: João Silva de Oliveira
                genero: Masculino
                data_nascimento: '1990-01-15'
                falecido: false
                obito: null
                parentes:
                  - nome: Maria Silva
                    vinculo_codigo: '01'
                    vinculo_nome: Cônjuge
                    documento: 987.654.321-00
                    tipo_documento: CPF
        '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:
    Obito:
      type: object
      description: Dados do registro de obito. Presente apenas quando falecido=true.
      properties:
        data_obito:
          type: string
          description: Data do obito (YYYY-MM-DD)
          example: '2017-07-15'
        cartorio:
          type: string
          description: Nome do cartorio onde o obito foi registrado
          example: Oficial do Rcpn 42 Subdistrito Jabaquara
    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

````