Pessoas

Buscar sócios por nome

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 sócios de empresas pelo nome completo ou parcial. Retorna pessoa + empresa + papel societário.

Rate limit: 100 req/min

01

Testar ao vivo

Parâmetros

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

Máximo de resultados (default: 10, máx: 20)

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/owners?name=Jo%C3%A3o+Silva' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'
02

Exemplo de retorno

{
  "data": [
    {
      "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
      "person_name": "Angelica Laureano",
      "cpf": "34791213734",
      "idade": 71,
      "sexo": "F",
      "role": "Sócio-Administrador",
      "company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf",
      "company_name": "Petrobras",
      "cnpj": "33000167000101",
      "segment": "Outras Industrias",
      "state": "RJ"
    }
  ],
  "meta": {
    "total": 12,
    "people": 4
  }
}
{
  "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": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retry_after": 42
  }
}
03

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

Começar grátis