---
title: "Company registration data ($0.005 via x402)"
method: GET
path: "/v1/cnpj/empresa/{cnpj}"
---

# Company registration data ($0.005 via x402)

`GET /v1/cnpj/empresa/{cnpj}`

## Request

- Base URL: `https://api.brazilayer.com`
- URL: `https://api.brazilayer.com/v1/cnpj/empresa/{cnpj}`
- Auth: none declared

## Path parameters

- `cnpj` string, required

## Response `200`

Registration card

- Empresa
  - `cnpj` string: 14 digits
  - `razao_social` string, nullable: legal name
  - `nome_fantasia` string, nullable: trade name
  - `matriz_filial` 'matriz' | 'filial' | 'null', nullable
  - `situacao_cadastral` object: registration status (Ativa = active, Baixada = closed)
    - `codigo` string, nullable
    - `descricao` string, nullable
    - `data` string, date, nullable
    - `motivo` string, nullable
  - `data_inicio_atividade` string, date, nullable
  - `natureza_juridica` CodigoDescricao
    - `codigo` string, nullable
    - `descricao` string, nullable
  - `porte` 'micro_empresa' | 'empresa_pequeno_porte' | 'demais' | 'nao_informado' | 'null', nullable
  - `capital_social` number, nullable
  - `cnae_principal` CodigoDescricao
    - `codigo` string, nullable
    - `descricao` string, nullable
  - `cnae_secundarios` CodigoDescricao[]
    - `codigo` string, nullable
    - `descricao` string, nullable
  - `endereco` object
    - `logradouro` string, nullable
    - `numero` string, nullable
    - `complemento` string, nullable
    - `bairro` string, nullable
    - `municipio` string, nullable
    - `uf` string, nullable
    - `cep` string, nullable
  - `contato` object
    - `email` string, nullable
    - `telefone` string, nullable
  - `simples` object: Simples/MEI small-business tax regime flags
    - `optante` boolean
    - `mei` boolean
  - `fonte` Fonte: Data source and reference month
    - `base` 'RFB/CNPJ'
    - `referencia` string, nullable: YYYY-MM

## Other responses

- `400`: Error envelope: { erro: { codigo, mensagem } }
- `402`: x402 payment required. The `payment-required` response header carries base64 JSON with accepted payment options (scheme "exact", USDC on Base, amount in 6-decimal units, payTo address). Sign an EIP-3009 authorization and retry with the `payment-signature` header. x402 client libraries automate this. If you are not using an x402 client, read the JSON body instead: it states the price and links the free sample of this dataset plus the free tools.
- `404`: Error envelope: { erro: { codigo, mensagem } }

---

[API](https://skmtc.dev/brazilayer/apis/brazilayer-brazilian-company-data-cnpj.md) · [All operations](https://skmtc.dev/brazilayer/apis/brazilayer-brazilian-company-data-cnpj/llms.txt) · [OpenAPI document](https://skmtc.dev/brazilayer/apis/brazilayer-brazilian-company-data-cnpj/revisions/609368003291?raw)