---
title: "Versionamento das APIs de consulta - NFE.io | Docs"
description: "Como a NFE.io versiona suas APIs de consulta: o que significa uma versão ser recomendada ou legada, e onde encontrar a versão certa para cada consulta."
source_url: https://nfe.io/docs/documentacao/consultas/versionamento
last_updated: 2026-07-22
---

# Versionamento das APIs de consulta

Algumas das nossas APIs de consulta têm mais de uma versão disponível ao mesmo tempo. Esta página explica o que cada status significa, para você saber qual versão usar.

## Status de versão

- **Recomendada (current):** a versão mais recente da API. Sem restrição de uso — é a que você deve escolher para integrações novas.
- **Legada (active-legacy):** uma versão anterior que **ainda responde normalmente**, mas foi substituída por uma versão recomendada. Não há data de descontinuação definida até o momento. Novas integrações devem preferir a versão recomendada.

Nenhuma versão listada como legada nesta seção está bloqueada ou retorna erro — "legada" significa apenas que existe uma versão melhor disponível.

## Versões por API

| API | Versão recomendada | Versão legada |
| --- | --- | --- |
| [Consulta de CNPJ](/documentacao/consultas/pessoa-juridica) | V3 | V2 |

Outras consultas desta seção podem ganhar página própria de versionamento quando tiverem mais de uma versão ativa.