Como consultar uma NFS-e pela chave de acesso (50 dígitos)

Para consultar uma NFS-e do padrão nacional, basta a chave de acesso de 50 dígitos. Com ela, você confere a nota no Emissor Nacional (se a sua empresa é a tomadora) ou na FiscalAPI, pela API ou no painel, sem programar. Na FiscalAPI, a consulta pela chave devolve os dados da nota e, se você pedir, o PDF do DANFSe, sem certificado digital. Custa de R$ 0,05 a R$ 2,01 por nota entregue, conforme o plano. Chave inválida e nota não encontrada não são cobradas.

Atualizado em 8 de novembro de 2026.

Onde está a chave de acesso da NFS-e#

A chave tem 50 dígitos. Ela aparece:

• No DANFSe, o PDF da nota, num bloco único de 50 dígitos no topo, ao lado do QR Code.
• No XML da NFS-e, no atributo Id, depois das letras NFS (por isso o Id tem 53 caracteres).
• No e-mail ou no sistema do prestador, quando ele envia a nota.

Chave com 44 dígitos é de NF-e (nota de produto), não de NFS-e. Veja os 50 dígitos da chave da NFS-e, campo a campo.

As formas de consultar, lado a lado#

Pelo Emissor Nacional#

Pelo Emissor Nacional, a empresa logada vê em "NFS-e recebidas" as notas em que aparece como tomadora ou intermediária. Ali dá para visualizar, baixar o XML, baixar o DANFSe e confirmar ou rejeitar a nota, conforme o guia oficial do Emissor Público Nacional.

Quando a nota não aparece#

A consulta pela chave nacional só encontra NFS-e do padrão nacional. Isso inclui as notas emitidas no Emissor Nacional e as que o município, com sistema próprio, compartilha com o Ambiente de Dados Nacional.

Desde 1º de janeiro de 2026, a LC 214/2025 (art. 62, § 1º) obriga municípios e o Distrito Federal a permitir a emissão no padrão nacional ou, se tiverem emissor próprio, a compartilhar as notas no leiaute nacional. Mesmo assim, uma nota antiga ou de um município que ainda não compartilha pode não aparecer. Nesse caso, confira no portal da prefeitura do prestador.

Na FiscalAPI: no painel ou pela API#

Na FiscalAPI, você consulta a NFS-e pela chave de dois jeitos. No painel, sem programar: cole a chave e veja a nota, com o PDF do DANFSe. Pela API, quando a nota precisa ir para o seu sistema. Não precisa de certificado, e quem consulta não precisa ser o emitente nem o tomador.

Pela API, a rota é GET /api/consultar-nfse, com a sua chave de API no cabeçalho X-API-Key. O exemplo usa uma chave fictícia, com dígito verificador válido:

curl --max-time 100 \
  "https://api.fiscalapi.com.br/api/consultar-nfse?chave=35503082211222333000181000000000012326100000045676" \
  -H "X-API-Key: fapi_sua_chave_aqui"

Um trecho da resposta (dados fictícios):

{
  "chave": "35503082211222333000181000000000012326100000045676",
  "numero_nfse": "123",
  "data_geracao": "2026-10-15T14:32:10-03:00",
  "situacao": { "codigo": "100", "descricao": "NFS-e Gerada" },
  "emitente": { "razao_social": "EMPRESA EXEMPLO SERVICOS LTDA", "cpf_cnpj": "11222333000181" },
  "tomador": { "cpf_cnpj": "99888777000166", "nome": "CLIENTE EXEMPLO S.A." },
  "tributacao_municipal": {
    "valor_servico": 1500.0,
    "aliquota": 2.0,
    "valor_issqn": 30.0,
    "retencao": "1 - Não Retido"
  },
  "cached": false,
  "danfse_pdf_base64": null
}

Com danfse=true, o campo danfse_pdf_base64 traz o PDF do DANFSe. A FiscalAPI não entrega o XML da NFS-e: a resposta é JSON, mais o PDF se você pedir.

O que saber antes de integrar:

• Tempo: em geral, de 30 a 60 segundos numa nota nova; com nova tentativa, até cerca de 90 segundos. Use timeout de pelo menos 100 segundos.
• Cache: o resultado de cada chave fica guardado por até 24 horas. Consulta repetida volta na hora, com cached: true, e é cobrada.
• Uma chave por requisição, com até 2 consultas de NFS-e em andamento por conta.
• No painel também. A mesma consulta está no painel da FiscalAPI, sem programar.

Todos os campos, erros e exemplos em Python, Node.js e PHP estão na documentação da consulta de NFS-e.

Quanto custa#

• Cobra só a nota entregue (resposta 200), com ou sem o PDF.
• Cobra também a consulta repetida que volta na hora, com cached: true.
• Não cobra chave inválida, nota não encontrada, limite atingido ou falha.
• Não entra nas consultas grátis do mês.

Veja planos e preços.

Perguntas frequentes#

Preciso de certificado digital para consultar uma NFS-e pela chave? Não. Na FiscalAPI, pela API ou no painel, basta a chave de 50 dígitos. O certificado (ou o login da empresa) entra quando você quer a lista de notas recebidas no Emissor Nacional.

Preciso ser o tomador da nota? Não para consultar pela chave. Quem tem a chave consegue conferir a nota.

Dá para baixar o XML da NFS-e pela chave? No Emissor Nacional, a empresa que é tomadora baixa o XML das notas recebidas. A API da FiscalAPI não entrega XML: devolve os dados em JSON e o PDF do DANFSe.

A consulta mostra se a nota foi cancelada? Não. A consulta traz o tipo de geração da nota (ex.: 100 - NFS-e Gerada). Não use esse campo como prova de que a nota não foi cancelada. Para isso, veja como saber se uma NFS-e foi cancelada ou substituída.

Funciona para nota de qualquer cidade? Funciona para NFS-e do padrão nacional. Nota que o município não compartilha com o ambiente nacional pode não ser encontrada. Na FiscalAPI, essa resposta (404) não é cobrada.

Fontes#

• Guia do Emissor Público Nacional Web, v1.2.1, seção 6 (NFS-e recebidas), gov.br/nfse
• Nota Técnica nº 008/2026, especificações do DANFSe, SE/CGNFS-e
• Guia das APIs do Emissor Público Nacional, gov.br/nfse
• Lei Complementar nº 214/2025, art. 62
• Consulta de NFS-e pela chave, documentação da FiscalAPI

Artigos relacionados#

• Chave de acesso da NFS-e: os 50 dígitos, campo a campo
• DANFSe: o que é e como baixar o PDF da NFS-e
• Como saber se uma NFS-e foi cancelada ou substituída
• Como conferir as retenções de uma NFS-e recebida

Confere notas de serviço no dia a dia? Veja como funciona a consulta de NFS-e pela chave ou crie sua conta e consulte no painel ou pela API.