Notas Fiscais

Consultar Nota Fiscal

Retorna uma nota pelo invoiceId devolvido na listagem — que na nota avulsa é o ref informado na emissão, e na nota de cobrança é o identificador da cobrança.

Traz os links do PDF e do XML e o código de verificação quando a nota já está autorizada. Quando a prefeitura recusou, nf.errors traz as mensagens do que precisa ser corrigido.

Nota inexistente, excluída ou de outra conta responde 404 com NOTA_NOT_FOUND.

Case de uso:

Como plataforma, quero buscar o PDF de uma nota para anexar ao e-mail que envio ao meu cliente.

GET/v1/invoices/notas/:notaid

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

Authorizations

bearer

Authorization

string · header · required

Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.

Escopos requeridos

nota.fiscal/read

Path Parameters

Name	Type	Required	Description
notaid	string	Required	Notaid

← Anterior

Resumo de Notas Fiscais

Emitir Nota Fiscal

const url = 'https://sandbox.validapay.com.br/v1/invoices/notas/{{notaId}}';

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {{token}}'
  },
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200200

{
  "emissor": {
    "configId": "unc_1788193720141_65g0zh12p",
    "cnpj": "99988877000108",
    "nome": "EMPRESA EXEMPLO LTDA"
  },
  "type": "NFSE",
  "invoiceId": "nf_1788101026585_uqaspo7bn",
  "chargeId": null,
  "customerId": null,
  "customerName": "Alexandre Souza",
  "taxId": "11144477735",
  "amount": 150.00,
  "emitidaEm": "2026-08-30T14:43:49.719Z",
  "ref": "2109541",
  "status": "ERROR",
  "feeStatus": null,
  "feeAmount": null,
  "nf": {
    "id": "2109541",
    "number": null,
    "status": "ERROR",
    "url": null,
    "pdfUrl": null,
    "xmlPath": null,
    "xmlUrl": null,
    "verificationCode": null,
    "rpsNumber": null,
    "rpsSeries": null,
    "cnpj": "99988877000108",
    "issuedAt": null,
    "errors": [
      {
        "mensagem": "Código de tributação nacional do ISS inválido para o município"
      }
    ]
  }
}

404404

{
    "error": {
        "message": "Nota fiscal não encontrada",
        "code": "NOTA_NOT_FOUND",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}

← Anterior

Resumo de Notas Fiscais

Emitir Nota Fiscal