---
title: "Dados cadastrais de um CNPJ"
method: GET
path: "/v1/cnpj/{cnpj}"
tags: ["Conta"]
---

# Dados cadastrais de um CNPJ

`GET /v1/cnpj/{cnpj}`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/cnpj/{cnpj}`
- Auth: HTTP bearer

Confere os dígitos verificadores (vale o CNPJ alfanumérico) e devolve a
razão social e o endereço cadastral, os mesmos que a emissão usa para
preencher o tomador sozinha. Consulta repetida sai do cache da Sudrel.
`encontrado: false` quando o CNPJ é válido mas a consulta cadastral não
trouxe dados.

## Path parameters

- `cnpj` string, required

## Response `200`

OK

## Other responses

- `400`: CNPJ inválido (posições ou dígitos verificadores).
- `401`: Chave de API ausente, inválida ou revogada.
- `429`: 120 requisições por minuto por chave excedidas (janela fixa de 60 s, alinhada ao relógio). Sem cabeçalho `Retry-After`: espere a virada do minuto. Nas rotas de conta, empresas e documentos o corpo é este; nas de emissão, lote, webhooks e eventos é problem+json `limite_de_requisicoes`.

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)