---
title: "Lista as NFS-e emitidas"
method: GET
path: "/v1/nfse"
tags: ["Emissão de NFS-e"]
---

# Lista as NFS-e emitidas

`GET /v1/nfse`

## Request

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

Mais recente primeiro, paginada por cursor. Uma página pode vir com
menos itens que `limite` e ainda ter `proximo_cursor` quando o
filtro é `transmitindo` ou `falha_transmissao`: continue até
`proximo_cursor` vir nulo.

## Query parameters

- `status` 'transmitindo' | 'autorizada' | 'rejeitada' | 'cancelada' | 'falha_transmissao' | 'descartada' | 'aguardando_confirmacao'
- `tomador` string
- `referencia` string
- `empresa_id` string
- `criada_de` string
- `criada_ate` string
- `limite` integer
- `cursor` string

## Response `200`

OK

- object
  - `dados` Nfse[]
    - `id` string
    - `referencia` string, nullable
    - `status` 'transmitindo' | 'autorizada' | 'rejeitada' | 'cancelada' | 'falha_transmissao' | 'descartada' | 'aguardando_confirmacao'
    - `empresa_id` string
    - `ambiente` 'producao' | 'sandbox': `sandbox` = emitida com chave de teste, no ambiente de testes do Sistema Nacional, sem valor fiscal.
    - `simulacao` string, nullable: Cenário do simulador de falhas (`X-Sudrel-Simular`); `null` em nota de verdade. Nota simulada nunca foi à Sefin.
    - `origem` 'api' | 'planilha' | 'manual' | 'monitoramento'
    - `numero` string, nullable
    - `chave_acesso` string, nullable
    - `dps` object, nullable
      - `serie` string
      - `numero` string
    - `valor` string: Texto decimal com ponto, sem separador de milhar. Número JSON é recusado (422 `tipo_invalido`).
    - `tomador` object
    - `servico` object
      - `codigo_nacional` string
      - `descricao` string
      - `competencia` string
      - `nbs` string, nullable: NBS escolhido para a nota, sem pontos. `null` = padrão da empresa ou da tabela oficial; o que foi declarado aparece nos `ajustes`.
      - `obra` ObraNfse, nullable
        - `cno` string, nullable
        - `cib` string, nullable
        - `inscricao_imobiliaria` string, nullable
        - `endereco` object, nullable
          - `cep` string
          - `logradouro` string
          - `numero` string
          - `complemento` string, nullable
          - `bairro` string
        - `municipio_ibge` string: Local da prestação.
    - `retencoes` object
    - `apuracao_propria` object
    - `iss` object
    - `rejeicao` object, nullable
      - `codigo_oficial` string, nullable
      - `mensagem` string: A mensagem do Sistema Nacional, como veio.
      - `explicacao` object, nullable: Explicação da Sudrel para o código oficial, quando ele é conhecido. `null` quando não é: aí vale só a `mensagem`.
        - `codigo` string: Estável, ex.: `aliquota_iss_obrigatoria`.
        - `campo` string, nullable: JSON Pointer no payload, quando é campo que você envia.
        - `mensagem` string
        - `correcao` string
    - `falha` object, nullable: Só em `falha_transmissao`.
      - `dps_enviada` 'nao' | 'desconhecido'
      - `mensagem` string, nullable
      - `correcao` string
    - `cancelamento` object, nullable
      - `em` string, date-time
      - `protocolo` string
      - `justificativa` string
    - `recuperada_em` string, date-time, nullable
    - `substituicao` object, nullable: Nesta nota (a nova), qual NFS-e ela substitui.
      - `nfse_id` string, nullable: `null` quando a original foi emitida fora da Sudrel.
      - `chave_acesso` string
      - `codigo_motivo` string
      - `motivo` string, nullable
    - `substituida_por` object, nullable: Nesta nota (a original, agora `cancelada` pelo Sistema Nacional), qual a substituiu.
      - `nfse_id` string
      - `links` object
        - `self` string
    - `confirmacao` object, nullable: Só em `aguardando_confirmacao`.
      - `motivo` 'competencia_encerrada'
      - `competencia` string
      - `mensagem` string
      - `correcao` string
    - `aviso` object, nullable: Só em `transmitindo`, depois de 30 minutos.
      - `codigo` 'processamento_prolongado'
      - `desde` string, date-time
      - `mensagem` string
    - `ajustes` Ajuste[]
      - `campo` string: JSON Pointer.
      - `acao` 'preenchido' | 'omitido' | 'derivado' | 'exigido'
      - `motivo` string
      - `regra` string: Identificador estável da regra.
    - `eventos` EventoNfse[]
      - `tipo` 'criada' | 'envio' | 'consulta_dps' | 'correcao_automatica' | 'reenfileirada' | 'falha_validacao' | 'recuperada' | 'cancelada' | 'substituida' | 'aguardando_confirmacao' | 'competencia_confirmada' | 'processamento_prolongado' | 'falha_transmissao'
      - `em` string, date-time
      - `detalhe` object
    - `regras_versao` string: Versões do catálogo de correções automáticas e do catálogo de regras de campo que decidiram esta nota, nessa ordem.
    - `criada_em` string, date-time
    - `atualizada_em` string, date-time
    - `links` object
      - `self` string
      - `xml` string
      - `pdf` string
  - `proximo_cursor` string, nullable

## Other responses

- `401`: `nao_autenticado`: chave de API ausente, inválida ou revogada.
- `429`: `limite_de_requisicoes` (`retentavel: true`): 120 requisições por minuto por chave, janela fixa de 60 s. Sem `Retry-After`: espere a virada do minuto e repita a MESMA requisição (com a mesma `Idempotency-Key`).

---

[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)