# Company Decision Oracle – Single-Entity Corporate Graph (CNPJ)

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

Builds a single Brazilian company's ownership, officer, address, and contact graph with risk propagation, explicitly flagging inferences, given only a CNPJ.

## Facts

- Endpoint: GET https://cdo-staging.up.railway.app/v1/agent/corporate-graph/:cnpj
- 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/company-decision-oracle-single-entity-corporate-graph-cnpj-a79925c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QMj50imovdJiy1AcZ0ndC

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-single-entity-corporate-graph-cnpj-a79925c3
```

Example prompt: Build me a full corporate graph for Brazilian company CNPJ 12.345.678/0001-90 — I need the owners, officers, address, and contacts as nodes and edges, with any inferred risk signals clearly flagged.

## When to prefer this

Use this endpoint when you need a structured graph representation of a single Brazilian company's internal corporate anatomy — owners, officers, address, contacts, and risk signals — and you have a CNPJ. Prefer this over generic lookup endpoints when you need node-edge output suitable for graph analysis or risk propagation, and when you specifically want inferences labeled separately from confirmed data. Do not use this if you need to discover other companies sharing an owner or address (cross-company reverse index); that capability is separate and currently disabled.

## Known failure modes

- Invalid or malformed CNPJ returns a validation error
- CNPJ not found in official Brazilian registry returns a not-found error
- Network or upstream data source timeout returns a service error
- Cross-company reverse index lookups return a disabled/unavailable error since backfill is incomplete
- Payment not provided or insufficient USDC balance returns a 402 error

## How this service works

SINGLE-ENTITY corporate graph: maps ONE company's own owners, officers, address and contacts into nodes + edges with local risk propagation. Inferences are explicitly flagged. Does NOT discover other companies that share an owner/address — that requires the cross-company reverse index, which is disabled until backfilled. CNPJ only.

## Output

A graph structure containing nodes for the company's owners, officers, registered address, and contacts, connected by typed edges representing relationships. Local risk signals are propagated through the graph and any inferred (non-confirmed) claims are explicitly flagged. Scope is strictly single-entity; cross-company reverse lookups (shared owner/address discovery) are not included.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/company-decision-oracle-single-entity-corporate-graph-cnpj-a79925c3/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)