Enriquecimento

Reverse lookup de pessoa física

POST consome créditos

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

Dado UM identificador (CPF, e-mail pessoal OU telefone), retorna contatos da pessoa física (e-mails, celulares, nome).

Resolução do identificador: e-mail/telefone são resolvidos primeiro na base TAMZ (grátis) e só seguem para uma fonte externa quando desconhecidos.

⚡ Consome créditos por dataset entregue: e-mail (enrich_email) + celular (enrich_celular). Sem dado = grátis. Contato da mesma pessoa já entregue em 30 dias (API ou MCP) = grátis.

Rate limit: 60 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-reverse' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "cpf": "12345678901"
}'
02

Corpo da requisição

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

03

Exemplo de retorno

{
  "data": {
    "cpf": "string",
    "name": "string",
    "emails": [
      "string"
    ],
    "phones": [
      "string"
    ],
    "phones_landline": [
      "string"
    ]
  },
  "meta": {
    "credits_used": 0,
    "credits_by_dataset": {},
    "source": "tamz"
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key. Use Authorization: Bearer tamz_xxx or X-API-Key header"
  }
}
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "required": 10,
    "available": 3,
    "upgrade_path": "/settings/plans",
    "next_action": "Top up credits and retry — zero-result searches are never charged."
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retry_after": 42
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
04

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

Começar grátis