# Brazilayer CNPJ Registry - Company Lookup

> Brazilayer CNPJ Registry - Company Lookup is a paid API for AI agents from api.brazilayer.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Fetches official registration data for a Brazilian company from the Receita Federal CNPJ registry by CNPJ tax ID

## Facts

- Endpoint: GET https://api.brazilayer.com/v1/cnpj/empresa/:cnpj
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brazilayer-cnpj-registry-company-lookup-69146e32
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8o2D7qKkIE_Az1doBQtzs

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 brazilayer-cnpj-registry-company-lookup-69146e32
```

Example prompt: Can you pull the official Receita Federal registration data for Brazilian company CNPJ 00.000.000/0001-91 — I need to see their legal name, registration status, address, and whether they're in the Simples Nacional regime?

## When to prefer this

Use this endpoint when you need official, government-sourced registration data for a single Brazilian company identified by its CNPJ. Prefer this over search-based endpoints when you already have the CNPJ and need the full legal profile. Ideal for KYB (Know Your Business) workflows, supplier verification, invoice validation, and compliance checks. More comprehensive than a name search and more targeted than the bundle endpoint if you only need registration data without partners/shareholders.

## Known failure modes

- Invalid or malformed CNPJ returns a 400 or 422 error
- CNPJ not found in registry returns 404
- Rate limiting or quota exceeded returns 429
- Data may be up to one month stale as it is updated monthly from Receita Federal
- Network timeout if the upstream Receita Federal source is unavailable

## How this service works

Official registration data for a Brazilian company from the Receita Federal (Brazilian IRS) CNPJ registry, updated monthly: legal name (razao_social), trade name, registration status (situacao_cadastral: Ativa=active, Baixada=closed), start date, legal nature, share capital, main and secondary CNAE activities with descriptions, full address, contact info and Simples/MEI tax regime flags. Keys are in Portuguese legal terms. Free sample, no payment: https://api.brazilayer.com/v1/cnpj/amostra

## Output

A JSON object with official Receita Federal data including: legal name (razao_social), trade name, registration status (situacao_cadastral: Ativa/Baixada/etc.), registration start date, legal nature code and description, share capital, main and secondary CNAE activity codes with descriptions, full registered address, phone/email contact info, and boolean flags for Simples Nacional and MEI tax regimes. All keys are in Portuguese legal terminology.

## 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"
     ],
     "type": "string"
    },
    "pathParams": {
     "cnpj": {
      "type": "string",
      "description": "Brazilian company tax ID (CNPJ), 14 digits, with or without punctuation (e.g. 00000000000191 or 00.000.000/0001-91)"
     },
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brazilayer-cnpj-registry-company-lookup-69146e32/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.brazilayer.com](https://www.zero.xyz/host/api.brazilayer.com/llms.txt)