# Brazilayer CNPJ Status Check

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

Checks whether a Brazilian CNPJ exists in the Receita Federal registry and returns its current registration status (active, suspended, or closed) along with headquarters/branch flag and state.

## Facts

- Endpoint: GET https://api.brazilayer.com/v1/cnpj/situacao/:cnpj
- Price: $0.001/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-status-check-a28ba703
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rIhmX4zC_XY6TNJ6pt9s6

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-status-check-a28ba703
```

Example prompt: Can you check whether CNPJ 11.222.333/0001-81 actually exists and is currently active in the Brazilian Receita Federal registry — not just a well-formed number, but a real, registered company?

## When to prefer this

Choose this endpoint when you need a fast, cheap ($0.001) authoritative check on whether a CNPJ is real and active — especially when digit-arithmetic validation alone is insufficient and you need ground-truth status from the official Receita Federal registry. Prefer this lightweight status endpoint over the full CNPJ data or bundle endpoints when you only need existence and registration status, not full company details or partner/shareholder data.

## Known failure modes

- CNPJ not found in registry — returns existence: false
- Malformed CNPJ input (not 14 digits after stripping punctuation) — likely returns 4xx error
- Receita Federal data temporarily unavailable — upstream outage may return 5xx
- CNPJ passes digit arithmetic but does not exist as a real registration — correctly returns non-existent

## How this service works

Does this CNPJ exist in the official Receita Federal registry, and is it active? Returns existence, registration status (situacao_cadastral: Ativa=active, Suspensa=suspended, Baixada=closed) with date, headquarters/branch flag and state. Cheapest paid check in the catalog: digit arithmetic alone cannot tell a well-formed number from a real, active company. Free sample, no payment: https://api.brazilayer.com/v1/cnpj/amostra

## Output

Returns whether the CNPJ exists in the official Receita Federal registry, its situacao_cadastral (Ativa = active, Suspensa = suspended, Baixada = closed) with the date of that status, a flag indicating whether the registration is for the headquarters or a branch, and the Brazilian state where it is registered.

## 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-status-check-a28ba703/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)