Exportar los envíos de un formulario

GET/v1/forms/{id}/submissions/export

Para desarrolladores

Descripción

Exporta en CSV los envíos confirmados recibidos por un formulario. Un envío queda pendiente de confirmación cuando el formulario exige doble opt-in — mientras no se confirma no tiene consentimientos vigentes, así que no se incluye en la exportación.

Guía relacionada

• Formularios — Arme formularios de captura y revise lo que se envió.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope form:read. Formato: Bearer FD.<key_id>.<token>.

X-Instance-Slugstringheaderobligatorio

Request

Path params:

idinteger

Identificador del formulario.

Response

200 OKRespuesta en streaming, Content-Type: text/csv (con BOM UTF-8, para que Excel detecte el encoding).text/csv

Columnas, en este orden:

submission_id

Identificador del envío.

submitted_at

Fecha y hora en que se envió el formulario.

confirmed_at

Fecha y hora en que el envío quedó confirmado.

contact_email

Email del contacto, si el formulario tiene un campo de tipo email.

*(una columna por cada campo del formulario)*

Una columna por cada ítem de tipo campo (kind=field) que tenga el formulario, con el field_key del campo como nombre de columna. Los ítems de consentimiento, separador y texto no generan columna. Un campo de tipo multiselect ocupa una sola columna: sus valores elegidos van separados por , dentro de la celda entrecomillada, de modo que el conjunto de columnas no cambia según cuántas opciones haya marcado cada contacto.

Nota

El conjunto de columnas depende de los campos configurados en el formulario — dos formularios distintos producen CSVs con columnas distintas.

Errores

Código	Cuándo
404	El id de formulario no existe en la cuenta.

Detalle completo en Errores genéricos.

Notas

• No pagina ni admite filtro de fecha: recorre siempre el histórico completo de envíos confirmados del formulario.
• Solo incluye envíos confirmed. Los pendientes de doble confirmación o expirados no se incluyen.

Request

curl -X GET "https://$API_HOST/v1/forms/5/submissions/export" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"

Response

submission_id,submitted_at,confirmed_at,contact_email
,,2026-05-08T14:22:31Z,