Pessoas

Gerar ou enriquecer pessoas em uma chamada

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.

Cobrança: consome créditos, por pessoa entregue (base) e mais 3 itens de preço. Fonte: tabela de operações da API TAMZ, 08/11/2026.

Uma chamada para gerar pessoas (filters na base ou company_cnpjs: pessoas atuais das empresas, ao vivo) OU enriquecer (cpfs, até 100, ou resolve: e-mail, celular, LinkedIn ou person_ref), com os módulos de include[] do catálogo (GET /api/v1/catalog).

CPF só no corpo deste POST — nunca em URL ou query string. O CPF só volta na resposta quando você o enviou, pagou o reverso ou o módulo cpf; nos outros casos o item traz person_ref, uma chave opaca do seu workspace que resolve[] aceita depois.

Preço por item: base (1 por pessoa entregue; pessoa ao vivo em company_cnpjs paga 2 no lugar, sócio não paga base) + reverso (só em acerto, em resolve[] por e-mail, celular ou LinkedIn) + a soma das inclusões entregues, pelo preço do seu workspace. Inclusão sem dado e dado já pago nos últimos 30 dias não cobram. A mesma pessoa repetida na chamada cobra uma vez. celular: até 3 números, só WhatsApp validado, ranqueados; sempre vindos do fluxo de enriquecimento (nunca direto da base). fixos (em celular e cpf) vem sempre como lista vazia: descontinuado.

Teto: max_credits nunca é ultrapassado — a chamada corta itens antes de rodar e devolve meta.truncated: true com meta.cursor.

dry_run: devolve estimate {min,max} e matches_bucket, sem débito e sem rodar inclusões.

⚡ Consome créditos do workspace.

Rate limit: 30 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/people/query' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "dry_run": false
}'
02

Corpo da requisição

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

03

Exemplo de retorno

{
  "data": [
    {
      "input": {},
      "status": "ok",
      "cpf": "string",
      "person_ref": "string",
      "reverso": {
        "status": "delivered",
        "data": {}
      },
      "base": {
        "nome": "string",
        "cargo": "string",
        "empresa": "string",
        "idade": 0,
        "sexo": "M",
        "linkedin_url": "string"
      },
      "base_status": "delivered",
      "includes": {
        "property1": {
          "status": "delivered",
          "data": null
        },
        "property2": {
          "status": "delivered",
          "data": null
        }
      }
    }
  ],
  "dry_run": true,
  "estimate": {
    "min": 0,
    "max": 0
  },
  "matches_bucket": "0",
  "meta": {
    "mode": "filters",
    "returned": 0,
    "truncated": true,
    "cursor": "string",
    "credits": {
      "reserved": 0,
      "charged": 0,
      "released": 0
    },
    "by_module": {
      "property1": {
        "items": 0,
        "credits": 0
      },
      "property2": {
        "items": 0,
        "credits": 0
      }
    },
    "by_unit": {
      "base": 0,
      "live": 0,
      "reverso": 0
    }
  }
}
Empty
Empty
Empty
Empty
Empty
Empty
04

Respostas e códigos

Response Body

application/json

Começar grátis