Empresas

Detalhe por CNPJ

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?cnpj=… (mesmo handler, com level). Continua respondendo com o mesmo envelope (data = objeto) e o mesmo preço.

Retorna dados completos de uma empresa pelo CNPJ (14 dígitos, sem pontuação) incluindo sócios vinculados.

Rate limit: 100 req/min

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' \
  -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
  }
}
{
  "error": {
    "code": "INVALID_CNPJ",
    "message": "Invalid CNPJ (must be 14 digits)"
  }
}
{
  "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