# MiniFrame CNPJ Company Profile Enrichment

> MiniFrame CNPJ Company Profile Enrichment is a paid API for AI agents from tools.miniframe.com.br, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Looks up a Brazilian company by CNPJ, enriches the record with CEP-completed address, and adds derived business flags including active status, HQ indicator, company age, MEI/Simples Nacional enrollment, size classification, and risk signals.

## Facts

- Endpoint: POST https://tools.miniframe.com.br/empresa
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/miniframe-cnpj-company-profile-enrichment-c85f4621
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YDKXji3Q7XVmNu9hp1nYj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability miniframe-cnpj-company-profile-enrichment-c85f4621 -d '<json body>'
```

Example prompt: I need to qualify a Brazilian supplier — can you look up CNPJ 12345678000195 and tell me if they're active, whether they're a headquarters, how old the company is, their size, and whether they're on Simples Nacional or MEI?

## When to prefer this

Choose this endpoint when you need a lead-qualification-ready company profile rather than a raw registry dump. It is specifically valuable when you need derived business intelligence flags (active status, HQ vs branch, MEI/Simples, age, size, risk signals) in a single call rather than stitching together multiple raw data sources. Prefer this over a raw CNPJ lookup endpoint when the consumer is a sales, compliance, or onboarding workflow that needs actionable enriched data.

## Known failure modes

- Invalid or malformed CNPJ (not 14 digits) returns a validation error
- CNPJ not found in Brazilian registry returns a not-found error
- CEP address lookup failure may result in incomplete address data
- Inactive or cancelled companies are returned but flagged as inactive
- Rate limiting or payment authorization failure returns a 402 error

## How this service works

Use when you need a Brazilian company profile ready to qualify a lead, not the raw registry. Looks up the CNPJ, completes the address via CEP, and adds derived flags: active, headquarters, age in years, MEI/Simples, size and risk signals. JSON body { cnpj } (14 digits). Personal fields omitted; partner tax IDs stay masked.

## Output

A structured JSON object containing the company's official registry data, address completed via CEP lookup, derived boolean flags (active, is_headquarters, is_mei, is_simples_nacional), company age in years, size classification, risk signals, and masked partner tax IDs. Personal fields are omitted for privacy.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cnpj": {
   "type": "string",
   "description": "Brazilian company tax ID, 14 digits."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cnpj": "00000000000191",
  "status": "Ativa",
  "address": {
   "zip": "70073901",
   "city": "Brasília",
   "state": "DF",
   "street": "Setor Bancario Sul",
   "zip_matches_city": true
  },
  "insights": {
   "risk": [],
   "size": "DEMAIS",
   "is_mei": false,
   "age_years": 60,
   "is_active": true,
   "is_simples": false,
   "is_headquarters": true
  },
  "partners": [
   {
    "name": "FULANO DE TAL",
    "role": "Diretor",
    "tax_id_masked": "***550179**"
   }
  ],
  "trade_name": "",
  "company_name": "BANCO DO BRASIL SA",
  "main_activity": {
   "code": 6422100,
   "description": "Bancos múltiplos, com carteira comercial"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/miniframe-cnpj-company-profile-enrichment-c85f4621/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.miniframe.com.br](https://www.zero.xyz/host/tools.miniframe.com.br/llms.txt)