# Consultar informações de pessoas físicas

Busca informações detalhadas de pessoa física por CPF

Endpoint: GET /persons
Version: 1.0
Security: ApiKeyAuth

## Query parameters:

  - `cpf` (string, required)
    CPF da pessoa (apenas números)
    Example: "12345678901"

  - `fields` (string)
    Campos específicos a retornar (separados por vírgula)
    Example: "name,cpf,emails,addresses"

## Response 200 fields (application/json):

  - `cpf` (string)
    Example: "11111111111"

  - `name` (string)
    Example: "FULANO DE TAL EXEMPLO"

  - `mother_name` (string)
    Example: "MARIA EXEMPLO"

  - `birthday` (string)
    Example: "1993-01-01"

  - `age` (string)
    Example: "30"

  - `gender` (string)
    Enum: "M", "F"

  - `sign` (string)
    Example: "Capricórnio"

  - `registry_situation` (string)
    Example: "REGULAR"

  - `pep` (boolean)

  - `pep_type` (string)

  - `possibly_dead` (boolean)

  - `retired` (boolean)

  - `bolsa_familia` (boolean)

  - `estimated_income` (string)
    Example: "ATÉ R$ 1.000,00"

  - `cbo_code` (string)
    Example: "999999"

  - `cbo_description` (string)
    Example: "EMPRESÁRIO"

  - `rg` (string,null)

  - `addresses` (array)

  - `addresses.type` (string)
    Example: "AVENIDA"

  - `addresses.street` (string)
    Example: "LOREM IPSUM"

  - `addresses.number` (string)
    Example: "1234"

  - `addresses.complement` (string)

  - `addresses.neighborhood` (string)
    Example: "BAIRRO EXEMPLO"

  - `addresses.city` (string)
    Example: "CIDADE EXEMPLO"

  - `addresses.district` (string)
    Example: "XX"

  - `addresses.postal_code` (string)
    Example: "12345000"

  - `addresses.priority` (integer)
    Example: 1

  - `emails` (array)

  - `emails.email` (string)
    Example: "exemplo@gmail.com"

  - `mobile_phones` (array)

  - `land_lines` (array)

  - `family_persons` (array)

  - `family_persons.description` (string)
    Example: "IRMAO"

  - `related_companies` (array)

  - `related_companies.cnpj` (string)
    Example: "55555555000101"

  - `related_companies.trading_name` (string)
    Example: "EMPRESA EXEMPLO"

  - `related_companies.company_name` (string)
    Example: "FULANO DE TAL EXEMPLO 11111111111"

  - `related_companies.ownership` (number)
    Example: 100

  - `employer` (array)

  - `ip` (string)
    Example: "127.0.0.1"

  - `plan` (string)
    Example: "Consulta Premium"

## Response 403 fields (application/json):

  - `error` (string)
    Example: "Invalid token"