---
title: "Consulta de CNPJ V2 (legada) - NFE.io | Docs"
description: "Referência da API de Consulta de CNPJ V2: endpoint, autenticação e por que migrar para a V3."
source_url: https://nfe.io/docs/documentacao/consultas/pessoa-juridica/consulta-cnpj-v2
last_updated: 2026-07-22
---

# Consulta de CNPJ — V2 (legada)

> **Legada:** a V2 ainda responde normalmente e não há data de descontinuação definida. Para integrações novas, use a [V3](./consulta-cnpj-v3).

## Endpoint

| Método | URL |
| --- | --- |
| GET | `https://legalentity.api.nfe.io/v2/legalentities/basicInfo/{federalTaxNumber}` |

O CNPJ é informado no parâmetro `federalTaxNumber`, sem barras, traços ou pontos.

## Limitação: CNPJ alfanumérico

A V2 **não aceita CNPJ no formato alfanumérico** (padrão pós IN RFB nº 2.229/2024, em vigor desde julho de 2026). Requisições com CNPJ contendo letras são rejeitadas na borda da API, antes de qualquer processamento:

- **HTTP `400 Bad Request`**, com o código de erro **`40001`** e a mensagem: `CNPJ alfanumérico não é suportado nesta versão. Utilize a v3.`

Se sua integração pode receber CNPJs alfanuméricos, trate o código `40001` como sinal de migração e use a [V3](./consulta-cnpj-v3). Veja o [guia de migração](./migracao-v2-para-v3).

## Autenticação

Mesma autenticação por API Key das demais APIs de consulta da NFE.io — veja [chaves de autenticação](/documentacao/nossa-plataforma/chaves-de-autenticacao).

## Documentação completa da API

A referência completa de campos, exemplos e códigos de status da V2 está na [documentação da API de Consulta de CNPJ (V2)](/desenvolvedores/rest-api/consulta-de-cnpj-v1).