# Maxwell x402 – Brazil CNPJ Company Lookup

> Maxwell x402 – Brazil CNPJ Company Lookup is a paid API for AI agents from api.maxwellinternational.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Returns registered company facts from Brazil's Receita Federal CNPJ register (via BrasilAPI) for a given CNPJ number, including registered name, trade name, status, legal form, and address.

## Facts

- Endpoint: GET https://api.maxwellinternational.ai/v1/gov/br/companies?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/maxwell-x402-brazil-cnpj-company-lookup-c9c4d881
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1Rx6x_8v61yDa6QbHcOv5

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 maxwell-x402-brazil-cnpj-company-lookup-c9c4d881
```

Example prompt: Can you look up the Brazilian company with CNPJ 33.000.167/0001-01 and tell me its registered name, trade name, legal status, and address from the Receita Federal register?

## When to prefer this

Choose this endpoint when you need authoritative, government-sourced company-level facts for a Brazilian entity identified by its CNPJ. It is ideal for KYC enrichment, vendor validation, invoice verification, or any workflow needing official Receita Federal data without standing up your own integration. Prefer it over generic web search when you need structured, machine-readable fields (name, status, legal form, address) rather than unstructured text. Note it covers company-level records only — not individual sole traders or partner details.

## Known failure modes

- 404 Not Found – CNPJ does not exist in the Receita Federal register (no charge applied)
- Invalid CNPJ format – malformed or non-numeric CNPJ string may be rejected
- BrasilAPI upstream outage – community service may be temporarily unavailable
- Rate limiting or payment failure – x402 payment not processed, request blocked
- Partner/sole-trader CNPJs (CPF-based) are explicitly out of scope and will not return data

## How this service works

One company from Brazil's CNPJ register (Receita Federal open data, via the community service BrasilAPI) by CNPJ: registered name, trade name, status, legal form, registered address and a link to the official register search. Company-level facts only; no partners or sole traders. Uncached: 404, not charged.

## Output

A JSON object containing: the CNPJ used (id), the official registered name, trade name, company status, legal form, registered address, country code (br), the data source attribution (BrasilAPI / Receita Federal), and a link to the official register search. Returns HTTP 404 (not charged) if the CNPJ is not found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cc": "br",
  "id": "33000167000101",
  "ok": true,
  "sku": "gov.br.companies",
  "name": "PETROLEO BRASILEIRO S A PETROBRAS",
  "found": true,
  "family": "companies",
  "source": "BrasilAPI (community service) over Receita Federal CNPJ open data",
  "country": "Brazil",
  "tradeName": "PETROBRAS - EDISE",
  "sourceClass": "official-api",
  "sourceLicence": {
   "url": "https://dados.gov.br/dados/conjuntos-dados/cadastro-nacional-da-pessoa-juridi...",
   "name": "Receita Federal CNPJ open data (public); served via BrasilAPI (MIT-licensed c..."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/maxwell-x402-brazil-cnpj-company-lookup-c9c4d881/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.maxwellinternational.ai](https://www.zero.xyz/host/api.maxwellinternational.ai/llms.txt)