# Company Decision Oracle – Brazilian CNPJ Basic Dossier

> Company Decision Oracle – Brazilian CNPJ Basic Dossier is a paid API for AI agents from cdo-staging.up.railway.app, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Verifies a Brazilian company's existence, legal status, and operational details by CNPJ, returning normalized registration data and machine-actionable onboarding signals.

## Facts

- Endpoint: GET https://cdo-staging.up.railway.app/v1/dossiers/br/basic/:cnpj
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/company-decision-oracle-brazilian-cnpj-basic-dossier-eefb30ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fHHMmSxY-LtqtUWln-l07

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 company-decision-oracle-brazilian-cnpj-basic-dossier-eefb30ee
```

Example prompt: Before I add CNPJ 11.222.333/0001-81 as a new vendor in our system, can you pull their official registration dossier and tell me if they're active, how old the company is, and whether it's a headquarters or a branch?

## When to prefer this

Choose this endpoint when you need to verify a Brazilian company by CNPJ before a commercial action such as onboarding a vendor, creating a customer record, or approving a payment. It is purpose-built for Brazilian CNPJ lookups with machine-actionable onboarding signals — use it instead of generic business-search APIs when you need official Receita Federal data, legal status, and structured due-diligence outputs in a single call. Not suitable for non-Brazilian companies or for individuals (CPF).

## Known failure modes

- Invalid or malformed CNPJ format — returns 4xx validation error
- CNPJ not found in the registry — returns not-found response
- Company exists but has no enriched data beyond basic registration — partial response with reduced fields
- Upstream Receita Federal data unavailable — returns 5xx or degraded-coverage response
- Payment not fulfilled via x402 protocol — request rejected before processing

## How this service works

Verify whether a Brazilian company exists and is operational before creating a vendor, customer or payment record. Returns normalized official registration data, legal status, company age, headquarters or branch status, business activities, address, declared capital, ownership information when available, tax-regime indicators when available, freshness, coverage and machine-actionable onboarding signals. Accepts Brazilian CNPJ only.

## Output

A normalized dossier containing: official company name, CNPJ status (active/inactive/suspended), company age in years, headquarters vs branch flag, primary and secondary CNAE business activity codes and descriptions, full registered address, declared share capital, ownership information when available, tax regime indicators (Simples Nacional, Lucro Presumido, etc.) when available, data freshness timestamp, coverage metadata, and machine-actionable boolean onboarding signals (e.g. is_active, is_hq, has_sanctions).

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/company-decision-oracle-brazilian-cnpj-basic-dossier-eefb30ee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cdo-staging.up.railway.app](https://www.zero.xyz/host/cdo-staging.up.railway.app/llms.txt)