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

# Einsendungen abrufen

> Es gibt keine REST-API für Einsendungen. Hier sind die drei tatsächlichen Wege, um an deine Daten zu kommen.

Falls du nach einem `GET /api/submissions`-Endpunkt suchst, den du abfragen kannst: den gibt es nicht.
Formpaste bietet keine allgemeine REST-API zum Lesen von Einsendungsdaten. Das ist
kein Versehen, das ist die aktuelle Form des Produkts. Es gibt drei tatsächliche Wege, um
Einsendungen abzurufen, sie decken den Dashboard-, den Bulk-Export- und den Agenten-Anwendungsfall ab.

## 1. Der Posteingang im Dashboard

Jedes Formular hat einen **Posteingang**-Tab (und einen **Spam**-Tab für [unter Quarantäne gestellte](/docs/de/features/quarantine)
Einsendungen) im [Dashboard](https://app.formpaste.com). Das ist die primäre,
stets aktuelle Ansicht, jede Einsendung, die die Spam-Filterung passiert, erscheint hier in
dem Moment, in dem sie eintrifft, zusammen mit der Kopie, die an deine Zieladresse gemailt wurde.

Nutze das, wenn ein Mensch Einsendungen lesen möchte.

## 2. CSV-Export

Für Bulk- oder Offline-Nutzung kannst du Einsendungen als CSV exportieren:

* **Pro Formular**: Exportiere aus dem Posteingang-Tab eines Formulars jede Einsendung dieses Formulars.
* **Kontoweit**: Exportiere unter **Einstellungen → Daten & Datenschutz** jede Einsendung über
  alle Formulare des Kontos hinweg in einer Datei.

Beide sind besitzerbezogen, du kannst nur Formulare exportieren, die dir gehören, und sie berücksichtigen das
[Aufbewahrungsfenster](/docs/de/features/submission-history) des Kontos. Siehe [CSV-Export](/docs/de/features/csv-export)
für das genaue Spaltenlayout.

Nutze das für Tabellenkalkulationen, einmalige Analysen oder um Einsendungen in ein Tool einzuspeisen, das
keinen Live-/programmatischen Zugriff benötigt.

## 3. Das MCP-Tool `list_submissions`

Für einen Agenten (oder jeden MCP-fähigen Client), der programmatischen, bedarfsgesteuerten Lesezugriff
benötigt, stellt der [MCP-Server](/docs/agents/mcp-server)
[`list_submissions`](/docs/agents/list-submissions) bereit, das Nächste, was es zu einer API zum Lesen von
Einsendungen gibt, und das einzige, das tatsächlich real ist:

```json theme={null}
{
  "name": "list_submissions",
  "arguments": { "formId": "frm_...", "folder": "inbox", "limit": 10 }
}
```

Es liefert Posteingang-/Spam-Zähler sowie eine Seite mit Einsendungen, standardmäßig nur mit Metadaten
(`id`, `created_at`, `folder`, `status`), übergib `includeContent: true`, um auch die
eingesendeten Felder zu erhalten (Name, E-Mail, Nachricht usw.), was deshalb explizit optional ist, weil diese
Daten die personenbezogenen Daten des Besuchers sind, nicht die des Formularinhabers. Siehe
[`list_submissions`](/docs/agents/list-submissions) für das vollständige Ein-/Ausgabeschema.

Nutze das, wenn ein Agent prüfen muss, "hat heute jemand etwas eingesendet?", oder aktuelle
Nachrichten zusammenfassen soll, ohne dass ein Mensch das Dashboard öffnet.

## Was es nicht gibt

Es gibt kein `GET /api/submissions`, kein `GET /api/forms/{id}/submissions`, keinen abfragbaren
REST-Endpunkt und keine von Webhooks unabhängige "Submissions-API" jenseits der drei oben genannten
Wege. Wenn Einsendungsdaten automatisch in dein eigenes System fließen sollen, sobald sie
eintreffen, statt bei Bedarf abgerufen zu werden, dann sind
[Webhooks](/docs/de/features/webhooks) (Pro) dafür da: Ein signierter POST wird bei jeder zugestellten
Einsendung in Echtzeit ausgelöst.

<CardGroup cols={2}>
  <Card title="list_submissions" icon="inbox" href="/docs/agents/list-submissions">
    Vollständiges Schema für das MCP-Tool.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/docs/de/features/webhooks">
    Push, nicht Pull, Echtzeit-Zustellung an deinen eigenen Endpunkt.
  </Card>

  <Card title="CSV-Export" icon="file-csv" href="/docs/de/features/csv-export">
    Bulk-Export, pro Formular oder kontoweit.
  </Card>

  <Card title="Einsendungsverlauf" icon="clock-rotate-left" href="/docs/de/features/submission-history">
    Aufbewahrungsfenster, die alle drei Abrufwege begrenzen.
  </Card>
</CardGroup>