# Retornar a pessoa por id

Permite consultar os detalhes de uma pessoa específica pelo seu identificador (id). A resposta inclui campos completos como nome, tipo de pessoa, documentos, perfis, contatos, endereços e demais informações pertinentes ao cadastro.

Endpoint: GET /v1/pessoas/{id}
Version: v1
Security: BearerAuth

## Path parameters:

  - `id` (string, required)
    id da pessoa

## Response 200 fields (application/json):

  - `ativo` (boolean)
    Ativo
    Example: true

  - `atrasos_pagamentos` (number)
    Atrasos nos pagamentos
    Example: 750.25

  - `atrasos_recebimentos` (number)
    Atrasos nos recebimentos
    Example: 1500.5

  - `codigo` (string)
    Código da pessoa
    Example: "CLI001"

  - `contato_cobranca_faturamento` (object)
    Contato para cobrança e faturamento

  - `contato_cobranca_faturamento.emails` (array)
    Email do contato de cobrança e faturamento
    Example: ["carlos.oliveira@email.com","joao.silva@email.com"]

  - `contato_cobranca_faturamento.whatsapp` (string)
    Telefone do contato de cobrança e faturamento
    Example: "5511999999999"

  - `criado_em` (string)
    Data de criação da pessoa (ISO 8601, São Paulo/GMT-3)
    Example: "2024-01-15"

  - `data_alteracao` (string)
    Data de alteração da pessoa (ISO 8601, São Paulo/GMT-3)
    Example: "2024-01-15T10:30:00"

  - `data_nascimento` (string)
    Data de nascimento
    Example: "1990-01-01"

  - `documento` (string)
    Documento da pessoa
    Example: "123.456.789-00"

  - `email` (string)
    Emails da pessoa separados por vírgula
    Example: "joao.silva@email.com, maria.silva@email.com"

  - `enderecos` (array)
    Endereços da pessoa

  - `enderecos.bairro` (string)
    Bairro do endereço
    Example: "Centro"

  - `enderecos.cep` (string)
    CEP do endereço
    Example: "12345-678"

  - `enderecos.cidade` (string)
    Cidade do endereço
    Example: "São Paulo"

  - `enderecos.complemento` (string)
    Complemento do endereço
    Example: "Apto 45"

  - `enderecos.estado` (string)
    Estado do endereço
    Example: "SP"

  - `enderecos.id` (string)
    ID do endereço
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `enderecos.id_cidade` (integer)
    ID da cidade
    Example: 3550308

  - `enderecos.logradouro` (string)
    Logradouro do endereço
    Example: "Rua das Flores"

  - `enderecos.numero` (string)
    Número do endereço
    Example: "123"

  - `enderecos.pais` (string)
    País do endereço
    Example: "Brasil"

  - `id` (string)
    ID da pessoa
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `inscricoes` (array)
    Informações fiscais

  - `inscricoes.id` (string)
    ID da informação fiscal
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `inscricoes.indicador_inscricao_estadual` (string)
    Indicador de inscrição estadual
    Enum: "NAO CONTRIBUINTE", "CONTRIBUINTE", "ISENTO"

  - `inscricoes.inscricao_estadual` (string)
    Inscrição estadual
    Example: "123456789"

  - `inscricoes.inscricao_municipal` (string)
    Inscrição municipal
    Example: "12345678901234"

  - `inscricoes.inscricao_suframa` (string)
    Inscrição SUFRAMA
    Example: "123456789"

  - `lembretes_vencimento` (array)
    Lembretes de vencimento

  - `lembretes_vencimento.ativo` (boolean)
    Status do lembrete de vencimento
    Example: true

  - `lembretes_vencimento.email` (string)
    Email do lembrete de vencimento
    Example: "lembrete@email.com"

  - `lembretes_vencimento.id` (string)
    ID do lembrete de vencimento
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `mensagem_pagamentos_abertos` (object)
    Mensagens de pagamentos em aberto

  - `mensagem_pagamentos_abertos.numero` (integer)
    Número de mensagens de pagamentos em aberto
    Example: 10

  - `mensagem_pagamentos_abertos.total` (integer)
    Total de mensagens de pagamentos em aberto
    Example: 10

  - `nome` (string)
    Nome da pessoa
    Example: "João Silva"

  - `nome_empresa` (string)
    Nome da empresa
    Example: "Empresa LTDA"

  - `observacao` (string)
    Observações gerais da pessoa
    Example: "Observação geral"

  - `optante_simples_nacional` (boolean)
    Optante do Simples Nacional
    Example: true

  - `orgao_publico` (boolean)
    Órgão público
    Example: true

  - `outros_contatos` (array)
    Outros contatos

  - `outros_contatos.cargo` (string)
    Escritório do contato
    Example: "Escritório Central"

  - `outros_contatos.email` (string)
    Email do contato
    Example: "maria.silva@email.com"

  - `outros_contatos.id` (string)
    ID do contato
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `outros_contatos.nome` (string)
    Nome do contato
    Example: "Maria Silva"

  - `outros_contatos.telefone_celular` (string)
    Celular do contato
    Example: "11987654321"

  - `outros_contatos.telefone_comercial` (string)
    Telefone comercial do contato
    Example: "1112345678"

  - `pagamentos_mes_atual` (number)
    Pagamentos do mês atual
    Example: 2500

  - `perfis` (array)
    Perfis da pessoa

  - `perfis.tipo_perfil` (string)
    Tipo de perfil: Cliente, Fornecedor ou Transportadora
    Enum: "Cliente", "Fornecedor", "Transportadora"

  - `pessoas_legado` (array)
    Pessoas legadas

  - `pessoas_legado.id` (integer)
    ID da pessoa legada
    Example: 12345

  - `pessoas_legado.perfil` (string)
    Perfil da pessoa legada
    Example: "CLIENTE"

  - `pessoas_legado.uuid` (string)
    UUID da pessoa legada
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `recebimentos_mes_atual` (number)
    Recebimentos do mês atual
    Example: 5000

  - `rg` (string)
    Registro Geral (RG) da pessoa. Para pessoas estrangeiras, este campo representa o identificador estrangeiro.
    Example: "12.345.678-9"

  - `telefone_celular` (string)
    Celular da pessoa
    Example: "(11) 98765-4321"

  - `telefone_comercial` (string)
    Telefone comercial da pessoa
    Example: "(11) 1234-5678"

  - `tipo_pessoa` (string)
    Tipo de pessoa
    Example: "FISICA"

## Response 400 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"