Saltar al contenido principal

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 confirmación. 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 <API_KEY>.
X-Instance-Slugstringheaderobligatorio
Identificador de su instancia. Ver Autenticación.

Request​

Path params:

idintegerobligatorio
Identificador del formulario.

Response​

200 OKRespuesta en streaming, en text/csv, con BOM UTF-8 para que las planillas reconozcan los acentos.text/csv
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.
Nota

Las columnas aparecen en el orden de esta tabla, seguidas de una columna por cada campo del formulario, en el orden de sus ítems:

  • Cada ítem kind=field genera una columna, con la field_key del campo como encabezado. Los ítems de consentimiento, separador y texto no generan columna.
  • Un campo de selección múltiple ocupa una sola columna, con sus valores separados por , dentro de la celda entrecomillada.
  • Dos formularios distintos producen CSV con columnas distintas.

Celdas que empiezan con =, +, - o @. Para que una planilla no ejecute como fórmula un texto que la contenga, el CSV antepone un apóstrofo (') a toda celda de texto que empiece con =, +, -, @, una tabulación o un retorno de carro. Lo mismo hace con los encabezados. Si un texto ya empieza con apóstrofos seguidos de uno de esos caracteres, recibe un apóstrofo más. Una celda que es solo un número, sin signo o negativo, se escribe sin cambios: -5, -1200.50. Un teléfono como +56912345678 sí lleva el apóstrofo, para que la planilla lo conserve como texto y no le quite el +. Si el archivo se abre directamente en Excel, el apóstrofo se ve dentro de la celda. Si las columnas se separan con Datos → Dividir texto en columnas (Excel para la web), o el archivo se importa en Google Sheets, el apóstrofo no se muestra y la celda presenta el valor tal como está guardado. Si procesa el archivo con un programa, quite un solo apóstrofo inicial de esas celdas.

Errores​

CódigoCuándo
404El id de formulario no existe en la cuenta (form_not_found).

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.
  • Los envíos 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" \
-o form-5-submissions.csv
Response
submission_id,submitted_at,confirmed_at,contact_email
1042,2026-05-08T14:20:10Z,2026-05-08T14:22:31Z,[email protected]