---
title: "Lista notas fiscais"
method: GET
path: "/v1/documents"
tags: ["Documentos"]
---

# Lista notas fiscais

`GET /v1/documents`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/documents`
- Auth: HTTP bearer

Lista paginada por cursor, com filtros combináveis.

## Query parameters

- `cnpjs` string
- `situacao` 'AUTORIZADA' | 'CANCELADA' | 'SUBSTITUIDA'
- `papel` 'RECEBIDA' | 'EMITIDA' | 'FORA_DE_ESCOPO': RECEBIDA = a empresa é a tomadora do serviço; EMITIDA = a empresa é a prestadora. FORA_DE_ESCOPO existe no filtro, mas não aparece nas listas: é o documento em que a empresa não é nenhuma das duas partes, que também não conta na franquia.
- `prestador` string
- `numero` string
- `chaveAcesso` string
- `valorMinCentavos` integer
- `valorMaxCentavos` integer
- `dataInicio` string, date-time
- `dataFim` string, date-time
- `tipoDocumento` 'NFSE' | 'NFE' | 'CTE'
- `ordenarPor` 'dataEmissao' | 'recebidaEm'
- `cicloCobranca` 'atual'
- `cursor` string
- `limite` integer

## Response `200`

OK

- object
  - `itens` NotaResumo[]
    - `id` string
    - `tipoDocumento` 'NFSE' | 'NFE' | 'CTE'
    - `numero` string
    - `nsu` string, nullable: Nulo quando o documento foi descoberto pela chave de acesso, sem NSU do ambiente nacional.
    - `chaveAcesso` string
    - `prestador` Prestador
      - `documento` string
      - `nome` string, nullable
    - `cnpjTomador` string
    - `papel` 'RECEBIDA' | 'EMITIDA' | 'FORA_DE_ESCOPO': RECEBIDA = a empresa é a tomadora do serviço; EMITIDA = a empresa é a prestadora. FORA_DE_ESCOPO existe no filtro, mas não aparece nas listas: é o documento em que a empresa não é nenhuma das duas partes, que também não conta na franquia.
    - `valorServicos` string
    - `situacao` 'AUTORIZADA' | 'CANCELADA' | 'SUBSTITUIDA'
    - `dataEmissao` string, date-time
    - `recebidaEm` string, date-time
    - `quantidadeEventos` integer
    - `quantidadeManifestacoes` integer
    - `manifestacaoVigente` 'CIENCIA_OPERACAO' | 'CONFIRMACAO_OPERACAO' | 'DESCONHECIMENTO_OPERACAO' | 'OPERACAO_NAO_REALIZADA' | 'PRESTACAO_SERVICO_DESACORDO': NF-e usa as quatro primeiras; CT-e, `PRESTACAO_SERVICO_DESACORDO`.
  - `proximoCursor` string, nullable

## Other responses

- `401`: Chave de API ausente, inválida ou revogada.
- `403`: A chave de teste (`sdr_test_`) não faz esta operação: ela emite NFS-e e NF-e na homologação e lê empresas. Use uma chave de produção (`sdr_live_`).
- `429`: 120 requisições por minuto por chave excedidas (janela fixa de 60 s, alinhada ao relógio). Sem cabeçalho `Retry-After`: espere a virada do minuto. Nas rotas de conta, empresas e documentos o corpo é este; nas de emissão, lote, webhooks e eventos é problem+json `limite_de_requisicoes`.

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)