Não. Vem a nota em JSON, campo a campo, e o DANFSe em PDF quando você pede (danfse=true).

Mostra se a nota foi cancelada?

Não. O campo situacao diz como a nota foi gerada: 100 gerada, 101 de substituição, 102 por decisão judicial, 103 avulsa. Veja como saber se a nota foi cancelada.

Funciona para qualquer município?

Vale para a NFS-e do padrão nacional, a de chave com 50 dígitos.

De onde vêm os dados da NFS-e?

Da Consulta Pública do Portal Nacional da NFS-e, lida no momento do pedido.

Para testar, não: a conta nova tem 10 consultas grátis por mês, e a NFS-e entra nelas. Para volume, qualquer plano serve, a partir do Lite (R$ 19,99/mês, 10 notas). Veja os planos.

Dá para consultar no painel?

Sim, sem programar: no painel, em NFS-e por Chave, cole a chave e veja a nota. Para integrar, gere a chave em Chave API e faça a chamada como no exemplo desta página.

Consulta de NFS-e pela chave de acesso, sem certificado

Envie a chave de 50 dígitos e receba a nota de serviço em JSON e o DANFSe em PDF. Não precisa ser o prestador nem o tomador.

Criar conta grátis Ver documentação

R$ 0,05 por nota no Enterpriseerro não cobra

NFS-e

35503082211222333000181000000000012326100000045676Exemplo

Valor do serviço

R$ 1.500,00

Número: 123
Gerada em: 15/10/2026
Prestador: EMPRESA EXEMPLO SERVICOS LTDA
Tomador: CLIENTE EXEMPLO S.A.
Serviço: Licenciamento de software - outubro/2026
ISSQN: R$ 30,00 · 2% · não retido

PDFDANFSe da NFS-e nº 123Na mesma chamada, com danfse=true

application/jsonExemplo

{
  "chave": "35503082211222333000181000000000012326100000045676",
  "numero_nfse": "123",
  "codigo_municipio_emissor": "3550308",
  "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",
    "inscricao_municipal": "1234567"
  },
  "tomador": {
    "cpf_cnpj": "99888777000166",
    "nome": "CLIENTE EXEMPLO S.A."
  },
  "servico": {
    "municipio": "São Paulo/SP",
    "codigo_tributacao_nacional": "010401",
    "descricao": "Licenciamento de software - outubro/2026"
  },
  "tributacao_municipal": {
    "tributacao_issqn": "1 - Operação Tributável",
    "valor_servico": 1500.0,
    "base_calculo": 1500.0,
    "aliquota": 2.0,
    "valor_issqn": 30.0,
    "retencao": "1 - Não Retido"
  },
  "tributacao_federal": {
    "valor_pis": 0.0,
    "valor_cofins": 0.0,
    "irrf": 0.0
  },
  "danfse_pdf_base64": "JVBERi0xLjQK…"
}

O que vem na consulta

A nota em JSON
Prestador, tomador e intermediário, serviço, ISSQN e tributos federais, em campos prontos para o seu sistema.
O DANFSe em PDF
Na mesma chamada, com danfse=true, para guardar ou anexar ao pagamento.
Só com a chave
Não precisa ser o prestador nem o tomador, nem ter certificado digital ou login de prefeitura.

O que a consulta de NFS‑e mostra e o que fica de fora

Mostra

Quem prestou o serviço, para quem e qual serviço.
O valor, o ISS e as retenções de tributos federais.
Como a nota foi gerada, em situacao: normal, de substituição, por decisão judicial ou avulsa.

Fica de fora

O XML da NFS-e. Vem a nota em JSON e o DANFSe em PDF.
Se a nota foi cancelada. Veja como saber.
NFS-e fora do padrão nacional, que não tem a chave de 50 dígitos.

A chave de acesso da NFS‑e tem 50 dígitos

3550308
Município emissor: São Paulo.
11222333000181
CPF ou CNPJ do prestador: 11.222.333/0001-81.
0000000000123
Número da NFS‑e: 123.
2610
Ano e mês de emissão: out/2026.

Pela API, uma chamada GET

A chave vai no header X-API-Key. Sem certificado digital.

GET/api/consultar-nfse

chaveobrigatório: Chave de acesso de 50 dígitos.
danfseopcional: true para receber também o DANFSe em PDF.
X-API-Keyobrigatório: Header com a sua chave da API.

curl -G https://api.fiscalapi.com.br/api/consultar-nfse \
  -d chave=35503082211222333000181000000000012326100000045676 \
  -d danfse=true \
  -H "X-API-Key: SUA_CHAVE_API"

application/jsonExemplo

{
  "chave": "35503082211222333000181000000000012326100000045676",
  "numero_nfse": "123",
  "codigo_municipio_emissor": "3550308",
  "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",
    "inscricao_municipal": "1234567"
  },
  "tomador": {
    "cpf_cnpj": "99888777000166",
    "nome": "CLIENTE EXEMPLO S.A."
  },
  "servico": {
    "municipio": "São Paulo/SP",
    "codigo_tributacao_nacional": "010401",
    "descricao": "Licenciamento de software - outubro/2026"
  },
  "tributacao_municipal": {
    "tributacao_issqn": "1 - Operação Tributável",
    "valor_servico": 1500.0,
    "base_calculo": 1500.0,
    "aliquota": 2.0,
    "valor_issqn": 30.0,
    "retencao": "1 - Não Retido"
  },
  "tributacao_federal": {
    "valor_pis": 0.0,
    "valor_cofins": 0.0,
    "irrf": 0.0
  },
  "danfse_pdf_base64": "JVBERi0xLjQK…"
}

chave: A chave consultada.
numero_nfse: Número da NFS-e.
codigo_municipio_emissor: Código IBGE do município que emitiu a nota.
data_geracao: Data e hora em que a nota foi gerada.
situacao: Como a nota foi gerada: 100 gerada, 101 de substituição, 102 por decisão judicial, 103 avulsa.
dps: Número, série e data da DPS.
emitente: Prestador: razão social, CPF ou CNPJ, inscrição municipal, Simples Nacional e endereço.
tomador: Nome, CPF ou CNPJ e inscrição municipal.
intermediario: Nome, CPF ou CNPJ e inscrição municipal, quando há.
servico: Município, código de tributação nacional, item da NBS e descrição.
tributacao_municipal: Valor do serviço, deduções, base de cálculo, alíquota, ISSQN e retenção.
tributacao_federal: PIS, COFINS, IRRF e contribuições retidas.
danfse_pdf_base64: O DANFSe em PDF, em base64, com danfse=true.

Bom saber

Pode colar a chave como estiver: com espaços, pontos, traços ou o prefixo NFS do XML.
O PDF vem em base64, no campo danfse_pdf_base64, quando você envia danfse=true.

Documentação da API (abre em outra aba)