Pessoas

Empresas onde a pessoa é sócia

GET 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.

Busca empresas em que uma pessoa figura como sócia (QSA oficial), por nome parcial. Degradação graciosa: se a busca exceder o tempo, retorna lista vazia com nota (use o nome completo).

⚡ Consome créditos por registro retornado (0 registros = grátis).

Rate limit: 100 req/min

01

Testar ao vivo

Parâmetros

Nome completo ou parcial do sócio (mín. 3 caracteres). Nomes completos retornam melhor.

Máximo de resultados (1–20, default 10)

Autorização

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

Sua requisição

curl -X GET 'https://tamz.ai/api/v1/search/by-owner?name=Jo%C3%A3o+Silva+Santos' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'
02

Exemplo de retorno

{
  "data": [
    {
      "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
      "person_name": "string",
      "role": "string",
      "company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf",
      "company_name": "string",
      "cnpj": "string",
      "segment": "string",
      "state": "string"
    }
  ],
  "meta": {
    "total": 0,
    "note": "string"
  }
}
{
  "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
  }
}
03

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

application/json

Começar grátis