# MiniFrame CNPJ Lookup

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

Fetches official Brazilian company registry data for a given CNPJ tax ID, returning legal name, status, address, CNAE activities, share capital, and partner list (QSA).

## Facts

- Endpoint: POST https://tools.miniframe.com.br/cnpj
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/miniframe-cnpj-lookup-20888661
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pm1OFtg29y5xICPMkdJzj

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-lookup-20888661 -d '<json body>'
```

Example prompt: Can you pull the official registration details for Brazilian company CNPJ 11222333000181 — I need to confirm their legal name, whether they're active, their registered address, and who the partners are?

## When to prefer this

Use this endpoint when you need authoritative, government-sourced Brazilian company data for a specific CNPJ — especially for supplier verification, lead enrichment, KYC due diligence, or confirming legal entity details before a business transaction. Prefer this over web scraping or third-party aggregators when official accuracy and structured output (including QSA partner list and CNAE codes) are required.

## Known failure modes

- Invalid or malformed CNPJ (not 14 digits) — returns validation error
- CNPJ not found in the registry — returns 404 or empty result
- Upstream Brazilian registry API unavailable — returns 503 or timeout
- Rate limiting or payment failure — returns 402 or 429

## How this service works

Use when you need a Brazilian company's official record from its CNPJ — checking a supplier is active, confirming a legal name, enriching a lead. JSON body { cnpj } (14 digits). Returns name, status, address, CNAE activities, share capital and the public partner list (QSA) with masked tax IDs. Personal contact fields omitted.

## Output

A JSON object containing the company's official legal name, current registration status (active/inactive/etc.), full registered address, list of CNAE economic activities, share capital amount, and the QSA (Quadro de Sócios e Administradores) partner list with masked tax IDs. Personal contact fields are excluded.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cnpj": {
   "type": "string",
   "description": "Brazilian company tax ID, 14 digits (with or without punctuation)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cnpj": "00000000000191",
  "size": "DEMAIS",
  "is_mei": false,
  "source": "brasilapi",
  "status": "ATIVA",
  "address": {
   "zip": "01310100",
   "city": "São Paulo",
   "state": "SP"
  },
  "partners": [
   {
    "name": "FULANO DE TAL",
    "role": "Diretor",
    "tax_id_masked": "***550179**"
   }
  ],
  "company_name": "BANCO DO BRASIL SA",
  "main_activity": {
   "code": 6422100,
   "description": "Bancos múltiplos"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/miniframe-cnpj-lookup-20888661/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)