> ## Documentation Index
> Fetch the complete documentation index at: https://userepass.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Payout batches (CLI)

> Comandos de consulta aos lotes de fechamento de ciclo (histórico de pagamentos agrupados por rodada).

O grupo `payout-batches` lê os **lotes de fechamento** de [payouts](/docs/conceitos/payouts): cada execução real de ciclo (`payouts run --live`) cria um lote que agrupa os payouts daquela rodada. É a base do histórico de "Ciclos" do painel. Só tem comandos de leitura.

## Consulta

```bash theme={null}
# Listar (paginado, filtro opcional por programa)
repass payout-batches list --program-id prog_xxx --json

# Buscar um lote pelo id
repass payout-batches get cyc_xxx --json
```

`payout-batches list` é paginado. Veja [Paginação](/docs/cli/paginacao) para `--all` e cursores.

```json repass payout-batches get cyc_xxx --json theme={null}
{
  "id": "cyc_01J9Z…",
  "programId": "prog_xxx",
  "status": "completed",
  "affiliateCount": 42,
  "totalCents": 1850000,
  "closingAt": "2026-07-01T00:00:00Z",
  …
}
```

O `status` do lote (`processing`, `completed`, `partial`) é derivado dos payouts-membro: `processing` enquanto houver payout agendado/em processamento, `completed` quando todos concluem, `partial` quando algum liquida com falha ou cancelamento.

<Note>
  Para o schema completo de `PayoutBatch` e os campos de cada objeto retornado, consulte a página SDK equivalente ([Payout batches](/docs/sdk/recursos/payout-batches)) e a [Referência da API](/docs/convencoes/ids-e-recursos). As regras de negócio estão em [Payouts](/docs/conceitos/payouts). A execução do ciclo que gera cada lote fica em `payouts run`. Veja [Payouts](/docs/cli/recursos/payouts).
</Note>