# CNPJ-X402 Brazilian Company Registry Lookup

> CNPJ-X402 Brazilian Company Registry Lookup is a paid API for AI agents from cnpj-x402-production.cnpj-x402.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-06).

Returns enriched, English-translated Brazilian company (CNPJ) data from Receita Federal, paid per call via x402 micropayment protocol

## Facts

- Endpoint: GET https://cnpj-x402-production.cnpj-x402.workers.dev/v1/company/%7Bcnpj%7D?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-06
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cnpj-x402-brazilian-company-registry-lookup-1ce5dd9d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3QT3PokiIzd79j5U33IIB

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 cnpj-x402-brazilian-company-registry-lookup-1ce5dd9d
```

Example prompt: Can you look up the Brazilian company registry data for CNPJ 33.000.167/0001-01 and tell me the legal name, current status, registered address, and who the partners are?

## When to prefer this

Choose this endpoint when you need structured, English-translated Brazilian company data without signing up for an API key — ideal for ad-hoc agent workflows, compliance checks, or vendor due diligence where pay-per-call micropayment via x402 is acceptable. Prefer it over scraping Receita Federal directly (unreliable, Portuguese-only) or subscription-based CNPJ APIs when usage is infrequent or per-query cost control matters.

## Known failure modes

- Invalid or malformed CNPJ returns a 4xx error
- CNPJ not found in Receita Federal database returns a not-found error
- Payment failure or insufficient USDC balance causes x402 payment rejection and no data returned
- Temporary upstream Minha Receita API unavailability causes 5xx errors
- Rate or quota limits on the upstream data source may delay fresh data

## How this service works

Paid API returning enriched, English-translated Brazilian company registry (CNPJ) data, normalized from official Receita Federal open data. Pay per call via the x402 protocol — no API key, no signup.

## Output

A JSON object containing the company's legal name, trade name, formatted and raw CNPJ, active status with effective date, full registered address, contact phone and email, founding date, list of partners with roles and join dates, primary and secondary CNAE activity codes with English labels, legal nature, company size, share capital in BRL, MEI flag, Simples Nacional opt-in status, branch/headquarters indicator, data source attribution, cache metadata, and retrieval timestamp — all fields translated into English.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mei": false,
  "cnpj": "33000167000101",
  "cache": {
   "hit": false,
   "ttl_seconds": 86400
  },
  "branch": {
   "label_en": "Headquarters",
   "is_headquarters": true
  },
  "source": "Receita Federal do Brasil open data (via Minha Receita)",
  "status": {
   "code": "02",
   "since": "2005-11-03",
   "label_en": "Active"
  },
  "address": {
   "zip": "20031170",
   "city": "RIO DE JANEIRO",
   "state": "RJ",
   "number": "65",
   "street": "REPUBLICA DO CHILE",
   "country": "BR",
   "district": "CENTRO",
   "complement": null,
   "state_name": "Rio de Janeiro"
  },
  "contact": {
   "email": null,
   "phone": "2121660000"
  },
  "founded": "1966-09-28",
  "partners": [
   {
    "name": "MAGDA MARIA DE REGINA CHAMBRIARD",
    "joined": "2024-06-07",
    "role_en": "President",
    "role_code": "16",
    "identifier_masked": "***612937**"
   }
  ],
  "legal_name": "PETROLEO BRASILEIRO S A PETROBRAS",
  "trade_name": "PETROBRAS - EDISE",
  "company_size": "OTHER",
  "legal_nature": {
   "code": "2038",
   "label_en": "Mixed-capital company"
  },
  "retrieved_at": "2026-07-22T19:46:35.936Z",
  "main_activity": {
   "cnae": "0600001",
   "label_en": "Extraction of crude oil and natural gas",
   "label_pt": "Extração de petróleo e gás natural"
  },
  "cnpj_formatted": "33.000.167/0001-01",
  "data_reference": null,
  "simples_nacional": {
   "since": null,
   "opted_in": false
  },
  "share_capital_brl": 205431960000,
  "secondary_activities": [
   {
    "cnae": "1921700",
    "label_en": "Manufacture of refined petroleum products",
    "label_pt": "Fabricação de produtos do refino de petróleo"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cnpj-x402-brazilian-company-registry-lookup-1ce5dd9d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cnpj-x402-production.cnpj-x402.workers.dev](https://www.zero.xyz/host/cnpj-x402-production.cnpj-x402.workers.dev/llms.txt)