API KeysDocumentação

Crie uma API Key para testar os endpoints ao vivo.

Criar API Key

Esta operação consome créditos do seu workspace por chamada.

get /api/v1/person

Parâmetros

Email da pessoa, profissional ou pessoal (use apenas um identificador por vez)

Telefone com DDD, com ou sem DDI e máscara — as formas de 10 e 11 dígitos são equivalentes (use apenas um identificador por vez)

URL do perfil LinkedIn — aceita com ou sem `www` e com ou sem barra final (use apenas um identificador por vez)

Autorização

Informe sua API key gerada em /developer/api-keys

Authorization

bearerAuth
AuthorizationBearer <token>

Informe sua API key gerada em /developer/api-keys

In: header

Query Parameters

email?string

Email da pessoa, profissional ou pessoal (use apenas um identificador por vez)

Formatemail
phone?string

Telefone com DDD, com ou sem DDI e máscara — as formas de 10 e 11 dígitos são equivalentes (use apenas um identificador por vez)

linkedin?string

URL do perfil LinkedIn — aceita com ou sem www e com ou sem barra final (use apenas um identificador por vez)

Formaturi

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://tamz.ai/api/v1/person?email=joao.silva%40totvs.com.br&phone=%2B5511987654321&linkedin=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fjoao-silva-santos"
{
  "data": {
    "id": "018e1234-abcd-7000-8000-000000000042",
    "name": "João Silva Santos",
    "job_title": "Diretor Comercial",
    "seniority": "Diretor",
    "department": "Comercial",
    "linkedin_url": "https://linkedin.com/in/joao-silva-santos",
    "has_email": true,
    "has_phone": false,
    "company": {
      "name": "TOTVS",
      "domain": "totvs.com.br",
      "state": "SP",
      "segment": "Software B2B",
      "revenue_range": "R$100M+"
    }
  },
  "meta": {
    "credits_used": 1,
    "cached": false,
    "source": "database"
  }
}
{
  "error": {
    "code": "MISSING_IDENTIFIER",
    "message": "Provide exactly one of: email, phone, linkedin"
  }
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key. Use Authorization: Bearer tamz_xxx or X-API-Key header"
  }
}
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits"
  }
}
{
  "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": "RATE_LIMITED",
    "message": "Rate limit exceeded"
  }
}