> ## 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.

# Recuperar envíos

> No hay una API REST de envíos. Aquí están las tres formas reales de sacar tus datos.

Si estás buscando un endpoint `GET /api/submissions` que consultar, no
existe. Formpaste no incluye una API REST de propósito general para leer
datos de envíos. Eso no es un descuido; es la forma actual del producto.
Hay tres formas reales de sacar los envíos, cubriendo el panel, la
exportación masiva, y los casos de uso con agentes.

## 1. El inbox del panel

Cada formulario tiene una pestaña **Inbox** (y una pestaña **Spam** para
los envíos en [cuarentena](/docs/es/features/quarantine)) en el
[panel](https://app.formpaste.com). Esta es la vista principal, siempre
actualizada, cada envío que pasa el filtrado de spam aparece aquí en el
momento en que llega, junto con la copia enviada por correo a tu dirección
de destino.

Úsala cuando un humano quiera leer envíos.

## 2. Exportación CSV

Para uso masivo o sin conexión, exporta los envíos como CSV:

* **Por formulario**: desde la pestaña Inbox de un formulario, exporta
  todos los envíos de ese formulario.
* **De toda la cuenta**: desde **Settings → Data & privacy**, exporta
  todos los envíos de todos los formularios de la cuenta en un archivo.

Ambas están limitadas al propietario, solo puedes exportar formularios que
posees, y respetan la [ventana de retención](/docs/es/features/submission-history)
de la cuenta. Consulta [Exportación CSV](/docs/es/features/csv-export) para el
diseño exacto de las columnas.

Úsala para hojas de cálculo, análisis puntuales, o para alimentar envíos a
una herramienta que no necesita acceso programático en vivo.

## 3. La herramienta MCP `list_submissions`

Para un agente (o cualquier cliente que hable MCP) que necesite acceso de
lectura programático y bajo demanda, el [servidor MCP](/docs/agents/mcp-server)
expone [`list_submissions`](/docs/agents/list-submissions), lo más parecido a
una API para leer envíos, y la que realmente es real:

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

Devuelve los contadores de inbox/spam más una página de envíos, solo
metadatos por defecto (`id`, `created_at`, `folder`, `status`), pasa
`includeContent: true` para obtener también los campos enviados (nombre,
correo, mensaje, etc.), lo cual es opcional específicamente porque esos
datos son información personal del visitante, no del propietario del
formulario. Consulta [`list_submissions`](/docs/agents/list-submissions) para
el esquema completo de entrada/salida.

Úsala cuando un agente necesite verificar "¿alguien envió algo hoy?" o
resumir mensajes recientes sin que un humano abra el panel.

## Lo que no existe

No hay ningún `GET /api/submissions`, ningún
`GET /api/forms/{id}/submissions`, ningún endpoint REST de consulta, y
ninguna "API de envíos" independiente de los webhooks más allá de los
tres caminos de arriba. Si necesitas que los datos de envíos fluyan a tu
propio sistema automáticamente conforme llegan, en lugar de extraerse bajo
demanda, para eso están los [webhooks](/docs/es/features/webhooks) (Pro): un POST
firmado se activa por cada envío entregado en tiempo real.

<CardGroup cols={2}>
  <Card title="list_submissions" icon="inbox" href="/docs/agents/list-submissions">
    Esquema completo de la herramienta MCP.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/docs/es/features/webhooks">
    Empuje, no extracción, entrega en tiempo real a tu propio endpoint.
  </Card>

  <Card title="Exportación CSV" icon="file-csv" href="/docs/es/features/csv-export">
    Exportación masiva, por formulario o de toda la cuenta.
  </Card>

  <Card title="Historial de envíos" icon="clock-rotate-left" href="/docs/es/features/submission-history">
    Ventanas de retención que limitan los tres caminos de recuperación.
  </Card>
</CardGroup>