Skip to main content
GET
/
NFe
/
ConsultarNFe
/
{chave}
Consulta Resumida
curl --request GET \
  --url https://api.validanfe.com/NFe/ConsultarNFe/{chave} \
  --header 'X-API-KEY: <x-api-key>'
{
  "200": {},
  "400": {},
  "401": {},
  "404": {},
  "429": {},
  "500": {},
  "Versao": "<string>",
  "TpAmb": "<string>",
  "CStat": "<string>",
  "XMotivo": "<string>",
  "ChNFe": "<string>",
  "DhRecbto": "<string>",
  "ProtNFe": {
    "InfProt.NProt": "<string>",
    "InfProt.DigVal": "<string>"
  },
  "Xml": "<string>"
}

​
Endpoint

​
Parâmetros

​
chave
string
required
Chave de acesso da NF-e (44 caracteres numéricos)Exemplo: 35170608530528000184550000000154301000771561

​
Headers

​
X-API-KEY
string
required
Token de autenticação da API
​
Accept
string
default:"application/json"
Tipo de conteúdo aceito na resposta

​
Exemplos de Requisição

curl -X GET "https://api.validanfe.com/NFe/ConsultarNFe/35170608530528000184550000000154301000771561" \
  -H "Accept: application/json" \
  -H "X-API-KEY: SEU_TOKEN_AQUI"

​
Códigos de Resposta

​
200
Success
NF-e encontrada e retornada com sucesso
​
400
Bad Request
Chave inválida ou mal formatada
​
401
Unauthorized
Token de autenticação ausente ou inválido
​
404
Not Found
NF-e não encontrada
​
429
Too Many Requests
Limite de requisições excedido (5/min)
​
500
Internal Server Error
Erro interno da API

​
Exemplo de Resposta

{
    "Versao": "4.00",
    "TpAmb": "1",
    "VerAplic": "SERPRO-API",
    "CStat": "100",
    "XMotivo": "Autorizado o uso da NF-e",
    "CUF": "35",
    "DhRecbto": "2024-03-10T12:34:56Z",
    "ChNFe": "35170608530528000184550000000154301000771561",
    "ProtNFe": {
        "Versao": "4.00",
        "InfProt": {
            "TpAmb": "1",
            "VerAplic": "SERPRO-API",
            "ChNFe": "35170608530528000184550000000154301000771561",
            "DhRecbto": "2024-03-10T12:34:56Z",
            "NProt": "123456789012345",
            "DigVal": "ABCDEFGHIJKLMNO",
            "CStat": "100",
            "XMotivo": "Autorizado o uso da NF-e"
        }
    },
    "Xml": "<xml_data_here>"
}

​
Campos da Resposta

​
Versao
string
Versão do layout da NF-e
​
TpAmb
string
Tipo de ambiente (1=Produção, 2=Homologação)
​
CStat
string
Código do status da consulta
​
XMotivo
string
Descrição do status
​
ChNFe
string
Chave de acesso da NF-e consultada
​
DhRecbto
string
Data e hora de recebimento da NF-e
​
ProtNFe
object
Protocolo de autorização da NF-e
​
Xml
string
XML completo da NF-e (se disponível)
Chaves de TesteUse a chave 87878774456468954646464654654546545446579312 para testar este endpoint sem consumir créditos.