Empresas

Sócios da empresa

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.

Lista os sócios e proprietários de uma empresa. Indica disponibilidade de email, telefone e LinkedIn (dados completos via enriquecimento).

Rate limit: 100 req/min

⚡ Consome créditos por chamada — empresa sem sócios não debita.

01

Testar ao vivo

Parâmetros

CNPJ com 14 dígitos (sem pontuação)

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/companies/33000167000101/owners' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'
02

Exemplo de retorno

{
  "data": [
    {
      "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
      "name": "Angelica Laureano",
      "cpf": "34791213734",
      "idade": 71,
      "sexo": "F",
      "role": "Diretor",
      "equity_pct": 25.5
    }
  ],
  "meta": {
    "company": "Petroleo Brasileiro S A Petrobras",
    "total": 9,
    "truncated": false
  }
}
{
  "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": "NOT_FOUND",
    "message": "Company not found"
  }
}
{
  "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