Listar NFS-e

Retorna a lista de NFS-e emitidas com filtros por período, status e busca textual.

GEThttps://api.nfer.me/v1/nfse

Headers da Requisição

X-API-Keystringobrigatório

Chave de API.

Parâmetros de Consulta (Query Parameters)

statusstringopcional

Filtro por status: "autorizada", "cancelada", "rascunho", "substituida", "erro".

searchstringopcional

Busca textual por tomador, descrição ou chave de acesso.

fromstring<date>opcional

Data inicial no formato YYYY-MM-DD.

Exemplo: 2026-09-01

tostring<date>opcional

Data final no formato YYYY-MM-DD.

Exemplo: 2026-09-30

limitintegeropcionalpadrão: 20

Limite de registros por página.

offsetintegeropcionalpadrão: 0

Deslocamento para paginação.

Listar NFS-e

curl --request GET \
  --url https://api.nfer.me/v1/nfse \
  --header 'X-API-Key: <sua_chave_api>'

{
  "items": [
    {
      "id": "e9b5a201-9231-4828-b0a3-a7c3df95a001",
      "numero": 329,
      "status": "autorizada",
      "valor_servico": "2500.00",
      "codigo_servico": "010701",
      "created_at": "2026-09-20T21:00:00.000Z"
    }
  ],
  "total": 1
}