# Enriquecer pessoas em lote

Enriquecimento em massa de pessoas físicas com processamento assíncrono e entrega via webhook.

Custo: 1 crédito por registro enriquecido com sucesso

Dados retornados: Mesmos do enriquecimento individual

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

## Request fields (application/json):

  - `contatos` (array, required)
    Array de contatos para enriquecer

  - `contatos.url_linkedin` (string)
    Example: "https://www.linkedin.com/in/exemplo"

  - `contatos.email` (string)
    Example: "exemplo@empresa.com"

  - `contatos.id_pessoa` (integer)
    Example: 12345

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

## Response 200 fields (application/json):

  - `job_id` (integer)
    Example: 12345

  - `status` (string)
    Example: "requested"

  - `total_contacts` (integer)
    Example: 100

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