Enriquecimento

Enriquecer pessoa

POST consome créditos

Cobrança por dataset entregue: você paga só o que pede no body e recebe. Nada encontrado = 0.

O preço desta operação para a sua conta fica em Configurações → Planos, já com o valor negociado do seu workspace.

Enriquece uma pessoa resolvendo UM identificador (id, email, celular OU linkedin_url) e rodando um ou mais datasets (perfil, whatsapp, email, email_profissional, processos).

Cobrança: só consome créditos por dataset entregue; o que não chega vai para meta.skipped (sem débito) e não aparece em data. Datasets já cacheados nos últimos 30d são servidos do cache (zero crédito) e aparecem em meta.cached.

whatsapp: só saem celulares com WhatsApp confirmado no enriquecimento. Cada número traz whatsapp_validated: true e wa_link (wa.me), e a lista vem ordenada por rank (1 = principal). A cobrança é por pessoa entregue, não por número. score (deprecated) só conta em quantas fontes o número aparece e não indica número antigo nem de outra pessoa.

⚡ Consome créditos do workspace.

Rate limit: 50 req/min.

01

Testar ao vivo

Autorização

Sua API key, gerada em /developer/api-keys. Gratuita para começar.

Sua requisição

curl -X POST 'https://tamz.ai/api/v1/enrichment/person' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "018e1234-abcd-7000-8000-000000000042",
  "email": "joao@empresa.com.br",
  "celular": "+5511987654321",
  "linkedin_url": "https://www.linkedin.com/in/joao-silva"
}'
02

Corpo da requisição

Request Body

application/json

Forneça exatamente UM identificador (id, email, celular OU linkedin_url) e ao menos um dataset.

TypeScript Definitions

Use the request body type in TypeScript.

03

Exemplo de retorno

{
  "data": {
    "perfil": {},
    "whatsapp": [
      {
        "numero": "41999998888",
        "whatsapp": true,
        "whatsapp_validated": true,
        "wa_link": "https://wa.me/554199998888",
        "rank": 1,
        "score": 2
      }
    ],
    "email": [
      {
        "email": "string",
        "validado": true
      }
    ],
    "email_profissional": {
      "email": "string",
      "status": "string"
    },
    "processos": {
      "total": 37,
      "distribution": {
        "by_court_type": {
          "property1": 0,
          "property2": 0
        },
        "by_status": {
          "property1": 0,
          "property2": 0
        },
        "by_level": {
          "property1": 0,
          "property2": 0
        },
        "by_state": {
          "property1": 0,
          "property2": 0
        }
      },
      "flags": [
        "string"
      ],
      "processes": [
        {
          "court_type": "TRABALHISTA",
          "court_name": "TRT2",
          "state": "SP",
          "status": "ATIVO",
          "subject": "string",
          "party_polarity": "ACTIVE",
          "party_type": "string",
          "value": 0,
          "capture_date": "2026-05-10"
        }
      ],
      "summary": "string"
    }
  },
  "meta": {
    "resolved_by": "id",
    "person_id": "018e1234-abcd-7000-8000-000000000201",
    "confidence": 1,
    "credits_used": 3,
    "credits_by_dataset": {
      "email": 3
    },
    "skipped": [
      {
        "dataset": "perfil",
        "reason": "no_data"
      }
    ],
    "cached": [
      "perfil"
    ],
    "source": "tamz"
  }
}
{
  "error": {
    "code": "INVALID_BODY",
    "message": "Body must be valid JSON"
  }
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key. Use Authorization: Bearer tamz_xxx or X-API-Key header"
  }
}
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "available": 2,
    "required": 5
  }
}
{
  "error": {
    "code": "WORKSPACE_BLOCKED",
    "message": "Workspace blocked"
  }
}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Company not found"
  }
}
{
  "error": {
    "code": "AMBIGUOUS_IDENTIFIER",
    "message": "This identifier is linked to more than one person — use a more specific one"
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters",
    "issues": [
      {
        "path": "id",
        "message": "Provide exactly one of: id, email, celular, linkedin_url"
      }
    ]
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retry_after": 42
  }
}
{
  "error": {
    "code": "ENRICHMENT_FAILED",
    "message": "Enrichment failed"
  }
}
{
  "error": {
    "code": "TEMPORARILY_UNAVAILABLE",
    "message": "Enrichment temporarily unavailable — retry later"
  }
}
04

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Começar grátis