# Enriquecer pessoa (individual)

Enriquece perfil de pessoa física individualmente com processamento assíncrono.

Custo: 1 crédito por registro enriquecido com sucesso

Dados retornados:
- Básicos: nome completo, CPF (quando disponível), idade, gênero, localização
- Contatos: telefones, emails, perfis públicos
- Vínculos empresariais: participações, cargos corporativos, CNPJs
- Histórico profissional: cargos, empresas, períodos
- Educação: cursos, instituições, níveis de escolaridade

A notificação de conclusão é enviada via webhook (se configurado).

Endpoint: POST /b2b/persons/enrich
Version: 1.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `contato` (object)

  - `contato.url_linkedin` (string)
    URL do perfil LinkedIn
    Example: "https://www.linkedin.com/in/exemplo"

  - `contato.email` (string)
    Email do contato
    Example: "exemplo@empresa.com"

  - `contato.id_pessoa` (integer)
    ID da pessoa (do endpoint de prospecção)
    Example: 12345

  - `url_webhook` (string)
    URL para notificação de conclusão
    Example: "https://seusite.com/webhook"

## Response 200 fields (application/json):

  - `id_processamento` (string)
    ID único do processamento
    Example: "4cb319e3bd9544019b45fd56911fa160"

  - `status` (string)
    Enum: "completed", "processing", "failed"

  - `total` (integer)
    Total de contatos processados
    Example: 1

  - `sucesso` (integer)
    Quantidade de enriquecimentos bem-sucedidos
    Example: 1

  - `falhou` (integer)
    Quantidade de enriquecimentos que falharam

  - `contatos` (array)

  - `contatos.tipo_entrada` (string)
    Example: "linkedin_url"

  - `contatos.valor_entrada` (string)
    Example: "https://www.linkedin.com/in/barboza-victor/"

  - `contatos.detalhes_contato` (object)

  - `contatos.detalhes_contato.informacoes_basicas` (object)

  - `contatos.detalhes_contato.experiencia_profissional` (object)

  - `contatos.detalhes_contato.educacao` (object)

  - `timestamp` (number)
    Example: 1760542724.0121257

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)
    Example: "no credits"

  - `error.description` (string)
    Example: "Você não possui saldo suficiente, disponível 0"

## Response 403 fields (application/json):

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