Listar Notas — Declara API

GET https://declara-web.vercel.app/api/v1/notas

Autenticação (Headers)

X-API-Keystringobrigatório

Sua Chave API (ex: sk_declara_a1b2c3...)

X-Declara-Emailstringobrigatório

E-mail cadastrado no Declara Web.

Query Parameters

desdestring

Data inicial no formato YYYY-MM-DD. Ex: 2026-01-01

atestring

Data final no formato YYYY-MM-DD. Ex: 2026-12-31

tipostring

Filtrar por tipo de nota: nfe, nfce ou nfse.

statusstring

Filtrar por status: autorizada ou cancelada.

limitenumber

Número de notas por página. Máximo: 200. Default: 50.

paginanumber

Página de resultados (começa em 1). Default: 1.

Resposta

notasarrayLista de notas fiscais

notas[].idstringUUID da nota no Declara

notas[].numerostringNúmero da nota fiscal

notas[].seriestringSérie da nota

notas[].tipostringnfe, nfce ou nfse

notas[].statusstringautorizada ou cancelada

notas[].valor_totalnumberValor total em reais (ex: 1500.00)

notas[].chave_acessostringChave de acesso de 44 dígitos

notas[].data_emissaostringData de emissão (ISO 8601)

notas[].destinatario.nomestringRazão social ou "Consumidor Final"

notas[].destinatario.cnpjstringCNPJ do destinatário (pode ser null)

notas[].pdf_urlstringURL para download do DANFE em PDF

totalnumberTotal de notas encontradas (com filtros)

paginanumberPágina atual

paginasnumberTotal de páginas disponíveis

limitenumberLimite de itens por página aplicado

Exemplos

curl "https://declara-web.vercel.app/api/v1/notas" \
  -H "X-API-Key: sk_declara_a1b2c3..." \
  -H "X-Declara-Email: empresa@email.com"

curl "https://declara-web.vercel.app/api/v1/notas?desde=2026-07-01&ate=2026-07-31&status=autorizada" \
  -H "X-API-Key: sk_declara_a1b2c3..." \
  -H "X-Declara-Email: empresa@email.com"

const params = new URLSearchParams({
  desde:  '2026-07-01',
  limite: '100',
  status: 'autorizada',
});

const res = await fetch(
  `https://declara-web.vercel.app/api/v1/notas?${params}`,
  {
    headers: {
      'X-API-Key':       'sk_declara_a1b2c3...',
      'X-Declara-Email': 'empresa@email.com',
    },
  }
);

const { notas, total } = await res.json();
console.log(`${total} notas encontradas`);

import requests
from datetime import date, timedelta

headers = {
    'X-API-Key':       'sk_declara_a1b2c3...',
    'X-Declara-Email': 'empresa@email.com',
}

# Últimos 30 dias
desde = (date.today() - timedelta(days=30)).isoformat()

r = requests.get(
    'https://declara-web.vercel.app/api/v1/notas',
    headers=headers,
    params={'desde': desde, 'status': 'autorizada', 'limite': 200}
)

for nota in r.json()['notas']:
    print(f"NF-e {nota['numero']} — R$ {nota['valor_total']:.2f}")

Resposta (200)

JSON

{
  "notas": [
    {
      "id":           "nota-uuid-1",
      "numero":       "42",
      "serie":        "1",
      "tipo":         "nfe",
      "status":       "autorizada",
      "valor_total":  1500.00,
      "chave_acesso": "35260700000000000000550010000000421234567890",
      "data_emissao": "2026-07-02T10:30:00.000Z",
      "created_at":   "2026-07-02T10:30:15.000Z",
      "destinatario": {
        "nome": "CLIENTE EXEMPLO LTDA",
        "cnpj": "11.222.333/0001-44"
      },
      "pdf_url": "https://declara-web.vercel.app/api/danfe-token?chave=35260700..."
    }
  ],
  "total":   1,
  "pagina":  1,
  "paginas": 1,
  "limite":  50
}