---
title: "Lista as NF-e"
method: GET
path: "/v1/nfe"
tags: ["Emissão de NF-e"]
---

# Lista as NF-e

`GET /v1/nfe`

## Request

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

Do ambiente da chave (sandbox ou produção), mais novas primeiro, com cursor.

## Query parameters

- `status` string
- `referencia` string
- `destinatario` string
- `empresa_id` string
- `criada_de` string, date
- `criada_ate` string, date
- `limite` integer
- `cursor` string

## Response `200`

OK

- object
  - `dados` Nfe[]
    - `id` string
    - `referencia` string, nullable
    - `status` 'transmitindo' | 'aguardando_confirmacao' | 'autorizada' | 'rejeitada' | 'denegada' | 'cancelada' | 'descartada' | 'contingencia_epec'
    - `empresa_id` string
    - `ambiente` 'sandbox' | 'producao'
    - `simulacao` string, nullable
    - `modo` 'informado' | 'calcular' | 'conferir'
    - `modelo` 55
    - `serie` integer
    - `numero` integer
    - `chave_acesso` string
    - `chaves_anteriores` string[]: Chaves que a nota teve antes de uma correção num mês seguinte.
    - `chave_referenciada` string, nullable: Chave da NF-e de origem referenciada (devolução, complementar); null quando a nota não referencia nenhuma.
    - `protocolo` string, nullable
    - `emitida_em` string, date-time, nullable
    - `autorizada_em` string, date-time, nullable
    - `valor_total` string, nullable
    - `sefaz` object, nullable
      - `cstat` string
      - `motivo` string
    - `rejeicao` NfeRecusa, nullable
      - `codigo_oficial` string: cStat da SEFAZ.
      - `mensagem` string: xMotivo da SEFAZ.
      - `explicacao` object, nullable
        - `codigo` string
        - `campo` string, nullable
        - `correcao` string
    - `denegacao` NfeRecusa, nullable
      - `codigo_oficial` string: cStat da SEFAZ.
      - `mensagem` string: xMotivo da SEFAZ.
      - `explicacao` object, nullable
        - `codigo` string
        - `campo` string, nullable
        - `correcao` string
    - `falha_envio` object, nullable: Nota em `transmitindo` que ainda não chegou à SEFAZ por uma falha antes do envio. Com `certificado_recusado_pela_sefaz`, a SEFAZ recusou o certificado sem processar a nota (nenhuma NF-e foi criada lá): a Sudrel tenta de novo em `proxima_tentativa`, e a prontidão mostra o item `certificado_sefaz`. Com `envio_pausado`, a recusa se repetiu (3 vezes, por padrão) e a Sudrel parou de tentar (webhook `NFE_ENVIO_PAUSADO`): a nota volta sozinha quando o certificado passar no teste da prontidão (um certificado novo, ou o mesmo uma hora depois).
      - `motivo` 'certificado_recusado_pela_sefaz' | 'envio_pausado' | 'uf_indisponivel' | 'falha_antes_do_envio'
      - `mensagem` string
      - `desde` string, date-time, nullable
      - `proxima_tentativa` string, date-time, nullable
      - `pausado_em` string, date-time, nullable
    - `contingencia` object, nullable: A nota entrou em contingência (veja Contingência da NF-e). Nulo na emissão normal.
      - `modo` 'svc_an' | 'svc_rs' | 'epec'
      - `tp_emis` 4 | 6 | 7
      - `situacao` 'em_contingencia' | 'autorizada_em_contingencia' | 'epec_registrado' | 'epec_prazo_proximo' | 'epec_rejeitado' | 'duplicata_cancelada' | 'duplicata_nao_cancelada' | 'duplicata_original_denegada'
      - `motivo` string: A justificativa (xJust) impressa no DANFE.
      - `desde` string, date-time
      - `chave_original` string: A chave tpEmis 1, que nunca foi transmitida.
      - `chave_original_transmitida` false
      - `epec` object, nullable
        - `protocolo` string
        - `registrado_em` string, date-time
        - `prazo_transmissao` string, date-time: 168 horas depois do EPEC.
        - `correcao` string, nullable
      - `reconciliacao` object, nullable
        - `em` string, date-time
        - `resultado` 'original_inexistente' | 'duplicata_cancelada' | 'duplicata_nao_cancelada' | 'duplicata_original_denegada'
    - `confirmacao` object, nullable
      - `motivo` string
      - `desde` string, date-time, nullable
      - `mensagem` string
      - `correcao` string
    - `descarte` object, nullable
      - `em` string, date-time
      - `automatico` boolean
      - `motivo` string, nullable
    - `cancelamento` object, nullable
      - `em` string, date-time
      - `protocolo` string
      - `justificativa` string
    - `cartas_correcao` object[]
      - `sequencia` integer
      - `texto` string
      - `status` 'transmitindo' | 'registrada' | 'rejeitada'
      - `protocolo` string, nullable
      - `sefaz` object, nullable
        - `cstat` string
        - `motivo` string
      - `em` string, date-time
    - `ajustes` object[]
      - `campo` string
      - `acao` 'preenchido' | 'derivado' | 'exigido' | 'omitido' | 'calculado' | 'divergente'
      - `motivo` string
      - `regra` string
      - `valor` unknown
      - `versao` string: Versão da regra, tabela ou calculadora.
      - `fonte` string: Fonte legal do valor.
    - `eventos` object[]
      - `tipo` string
      - `em` string, date-time
      - `detalhe` object
    - `regras_versao` string
    - `criada_em` string, date-time
    - `atualizada_em` string, date-time
    - `links` object
      - `self` string
      - `xml` string
      - `danfe` 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)