---
title: "ay list"
source: "https://ayoune.com/de/docs/cli/befehls-referenz/crud-core/ay-list"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "de"
retrieved: "2026-08-27T21:25:16.059Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `ay list` (Alias: `l`)

Listet Dokumente einer Collection mit Paginierung, Sortierung und optionalen Filtern.

## Syntax

```
ay list <collection> [flags]
```

## Flags

| Flag | Default | Zweck |
|---|---|---|
| `--limit N` | 20 | Anzahl Ergebnisse pro Page |
| `--skip N` | 0 | Offset |
| `--sort <field>:<-1\|1>` | `createdAt:-1` | Sortierung |
| `--filter '<json>'` | `{}` | MongoDB-Filter-Objekt |
| `--fields '<json>'` | alle | Projection |
| `--format` | config-default | `json` / `yaml` / `table` / `csv` |
| `-m` / `--minimal` | false | Nur Payload, kein `{payload, meta}`-Envelope |

## Beispiele

```bash
# Einfache Liste mit 5 Einträgen
ay list consumers --limit 5

# Gefiltert, nur ausgewählte Felder
ay list orders \
  --filter '{"status":"paid","total":{"$gte":100}}' \
  --fields '{"_id":1,"total":1,"consumer":1}' \
  --sort 'createdAt:-1' \
  --limit 10

# Export zu CSV
ay list invoices -f csv -m > invoices.csv
```

## Paginierung

Bei mehr als `--limit` Treffern zeigt die CLI:

```
Showing 20 of 1347 matching docs (page 1 of 68)
Next page: ay list consumers --skip 20
```

## Performance-Tipp

```bash
ay list <collection> --no-sort           # schnellster Path, überspringt Sortier-Stage
ay list <collection> --skip-count        # kein Total-Count (schneller bei großen Collections)
```

## Fehlerfälle

- **HTTP 403** — Keine Rechte auf Collection. Via `ay access` prüfen.
- **HTTP 404** — Collection existiert nicht. `ay modules` für korrekten Namen.
- **Filter-Syntax-Error** — JSON muss valide sein; bei Shell-Escaping-Problemen via Heredoc oder File.

## Siehe auch

- [get](wiki:cli/crud-core/get) — einzelner Datensatz
- [search](wiki:cli/queries/search) — Volltextsuche

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com