Enriquecer em massa (uma chamada)

Centenas ou milhares de leads em UMA chamada — o MCP e o /enrichment/batch ficam nos lotes de até 20.

Mande list_id (lista do workspace) ou items (até 10.000: cnpj, domain, company_id, person_id, linkedin_url, email) e os datasets. Com list_id, os membros passam pelos mesmos filtros dos items: quem não pode receber nenhum dataset pedido (sem CPF e sem LinkedIn) ou está fora da base exportável sai em unresolved, e o lote roda numa lista interna só com os aptos (fora de Listas e do limite de listas do plano). Quem atende só parte dos datasets entra; a etapa que a pessoa não atende sai como no_data, sem cobrança. Nenhum aceito → 422 NOTHING_RESOLVED, nada cobrado. Com itens de empresa e datasets de contato, o TAMZ acha os decisores (bloco people, padrão C-Level/sócio, 1 por empresa).

Fluxo: dry_run: true devolve a estimativa e o request_key (o dry_run já monta a lista e a prévia, sem executar nem cobrar; sem request_key, cada dry_run monta uma lista nova). Envie o mesmo request_key com max_credits ≥ estimativa em até 30 min para reaproveitá-las — o lote é aprovado e começa na hora (202 + job_id). Depois de 30 min → 409 ESTIMATE_EXPIRED; o mesmo request_key com outro pedido → 409 REQUEST_KEY_CONFLICT (use um novo). Teto abaixo da estimativa → 422 CEILING_TOO_LOW, nada executa nem é cobrado. Limite: itens × datasets ≤ 4.000 por chamada (JOB_TOO_LARGE). A aquisição conta na cota diária de volume do workspace.

Celular só sai com WhatsApp confirmado; validação de WhatsApp fora aparece como unavailable no status e whatsapp_unavailable no CSV, sem cobrança.

⚡ Consome créditos só por dataset entregue (cache do workspace sai grátis).

Rate limit: 10 req/min

curl -X POST 'https://tamz.ai/api/v1/enrichment/bulk' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "dry_run": false
}'

{
  "dry_run": true,
  "request_key": "57cadb9d-efba-4c3f-8576-3d122dfdc17a",
  "list_id": "430bbdbc-9d7f-4d06-a273-67ca4ba4ae4b",
  "pricing": "per_item",
  "resolved": 0,
  "unresolved": [
    {
      "input": {
        "type": "cnpj",
        "value": "string"
      },
      "reason": "invalid"
    }
  ],
  "estimate_credits": 0,
  "members": 0,
  "with_contact_path": 0,
  "without_contact_path": 0,
  "not_eligible": 0
}

{
  "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
  "status_url": "string",
  "request_key": "57cadb9d-efba-4c3f-8576-3d122dfdc17a",
  "list_id": "430bbdbc-9d7f-4d06-a273-67ca4ba4ae4b",
  "pricing": "per_item",
  "resolved": 0,
  "unresolved": [
    {
      "input": {
        "type": "cnpj",
        "value": "string"
      },
      "reason": "invalid"
    }
  ],
  "estimate_credits": 0
}

{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Parâmetros inválidos"
  }
}

{
  "error": {
    "code": "BULK_NOT_ENABLED",
    "message": "Enriquecimento em lote indisponível para este workspace."
  }
}

{
  "error": {
    "code": "LIST_NOT_FOUND",
    "message": "Lista não encontrada neste workspace."
  }
}

{
  "error": {
    "code": "CEILING_TOO_LOW",
    "message": "O lote pode custar até 284 créditos; max_credits é 100. Nada foi executado nem cobrado."
  }
}