---
title: "Lista os lotes"
method: GET
path: "/v1/lotes"
tags: ["Emissão em lote"]
---

# Lista os lotes

`GET /v1/lotes`

## Request

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

Mais recente primeiro, por cursor. Lista os lotes criados pela API e
pela planilha do painel (a chave de sandbox vê só os de sandbox). Com
`status`, a página pode vir menor que `limite`: continue até
`proximo_cursor` vir nulo. A última página pode vir vazia.

## Query parameters

- `status` 'validando' | 'aguardando_emissao' | 'processando' | 'concluido' | 'erro'
- `criado_de` string
- `criado_ate` string
- `limite` integer
- `cursor` string

## Response `200`

OK

- object
  - `dados` Lote[]
    - `id` string
    - `tipo` 'nfse' | 'nfe': O que o lote emite. No de NF-e, `contagens` conta notas e traz `linhas` (os itens das notas).
    - `status` 'validando' | 'aguardando_emissao' | 'processando' | 'concluido' | 'erro': `validando` → (`aguardando_emissao`, só com `ao_validar: "aguardar"`) → `processando` → `concluido`. `concluido` quer dizer que nenhuma nota do lote está mais transmitindo; pode haver rejeitadas e linhas com erro.
    - `empresa_id` string
    - `ambiente` 'producao' | 'sandbox'
    - `origem` 'api' | 'painel'
    - `formato` 'json' | 'planilha'
    - `ao_validar` 'emitir_validas' | 'aguardar', nullable
    - `contagens` object: Linhas por status. `total` é o número de linhas recebidas.
      - `total` integer
      - `transmitindo` integer
      - `autorizada` integer
      - `rejeitada` integer
      - `falha_transmissao` integer
      - `aguardando_confirmacao` integer
      - `cancelada` integer
      - `descartada` integer
      - `com_erro_validacao` integer
      - `aguardando_emissao` integer
      - `ja_existente` integer
    - `criado_em` string, date-time
    - `validado_em` string, date-time, nullable
    - `emissao_disparada_em` string, date-time, nullable
    - `concluido_em` string, date-time, nullable
    - `links` object
      - `self` string
      - `itens` string
      - `relatorio` 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)