Export Submissions

Exports submissions for a form as a CSV file. The response streams the CSV content, so it handles large exports efficiently.


GET /v1/forms/{formId}/export

Request


curl "https://api.formtorch.com/v1/forms/a1b2c3d4e5/export?range=7days" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o submissions.csv

Path parameters

Parameter	Description
`formId`	The 10-character form ID

Query parameters

Parameter	Type	Default	Description
`range`	string	`all`	Date range: `24hours`, `7days`, `30days`, `all`
`spam`	boolean	`false`	Include spam submissions in the export

Response

Returns a text/csv stream with the following headers:


Content-Type: text/csv; charset=utf-8
Content-Disposition: attachment; filename="submissions-a1b2c3d4e5-7days.csv"

CSV format

The first row contains column headers. Nested objects are flattened with dot notation.


id,submittedAt,isSpam,name,email,message
x9y8z7w6v5,2025-03-15T14:30:00.000Z,false,Alex,alex@example.com,Hello there
m4n5o6p7q8,2025-03-14T09:15:00.000Z,false,Jordan,jordan@example.com,Inquiry about pricing

Formula injection is blocked: values beginning with =, +, -, or @ are prefixed with a single quote to prevent spreadsheet formula execution.

Download from the dashboard

You can also export submissions without the API: go to your form’s Submissions page in the dashboard and click Export CSV. The dashboard export supports the same date range filters.