Empresas

Resolver empresa por domínio (0% FP)

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.

Obsoleto — desligado em 2026-12-21. Use o endpoint novo.

Obsoleto — use GET /api/v1/company?domain=… (mesmo handler, com level). Continua respondendo com o mesmo envelope (data = objeto) e o mesmo preço.

Resolve um domínio para a empresa dona via mapa verificado domínio→CNPJ (tamz_core.ext_domains, regra 0% falso-positivo: só verified/high com 1 cnpj_root). Domínio compartilhado ou de baixa confiança → 404 sem chute. Retorna o cnpj_root para puxar sócios (QSA) e colaboradores.

⚡ Consome créditos por empresa resolvida.

Rate limit: 100 req/min

⚡ Consome créditos por empresa resolvida — unmatched/ambiguous não debitam.

01

Testar ao vivo

Parâmetros

Domínio (apex). Ex: totvs.com.br

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/domain/totvs.com.br' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'
02

Exemplo de retorno

{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "cnpj": "33000167000101",
    "cnpj_root": "33000167",
    "type": "matriz",
    "legal_name": "Petroleo Brasileiro S A Petrobras",
    "trade_name": "Petrobras - Edise",
    "status": "Ativa",
    "opening_date": "1953-10-03",
    "cnae_main_id": "0600001",
    "cnae_main_desc": "Extração de petróleo e gás natural",
    "macro_segment": "Industria & Manufatura",
    "segment": "Outras Industrias",
    "sub_segment": "Industria Diversa",
    "natureza_juridica_desc": "Sociedade Anônima Aberta",
    "porte_da_empresa": "Demais",
    "mei_optante": false,
    "capital_social": 205431960490.29,
    "people_count": 50874,
    "revenue_range": "ACIMA DE 1BI",
    "size_range": "500-999",
    "veiculos_faixa": "500+",
    "website": "petrobras.com.br",
    "logo_url": "https://logo.tamz.ai/petrobras.com.br",
    "linkedin_url": "https://linkedin.com/company/petrobras",
    "linkedin_followers": 2145000,
    "address_zip": "20031-912",
    "address_street": "Avenida Republica do Chile",
    "address_number": "65",
    "address_city": "Rio de Janeiro",
    "address_state": "RJ",
    "address_country": "BR",
    "owners": [
      {
        "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
        "name": "Angelica Laureano",
        "cpf": "34791213734",
        "idade": 71,
        "sexo": "F",
        "role": "Diretor",
        "equity_pct": 25.5
      }
    ],
    "owners_truncated": false,
    "match_confidence": "verified"
  }
}
{
  "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."
  }
}
{
  "data": null,
  "match": "unmatched"
}
{
  "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

application/json

Começar grátis