Skip to Content

Export Submissions

CSV export is a dashboard feature. It is not part of the Bearer-auth REST API and cannot be called with an API key. Use the List Submissions endpoint to fetch submissions programmatically.

The export endpoint streams a CSV file for a given form. It requires an active dashboard session (Clerk cookie auth) and is available at:

GET https://app.formtorch.com/api/export/csv/{formId}?range=30days

Query parameters

ParameterTypeDefaultDescription
rangestring30daysDate range: 24hours, 7days, 30days, all

CSV format

The first row contains column headers. Metadata columns appear first, followed by one column per form field sorted alphabetically.

ColumnDescription
TimestampISO 8601 submission timestamp
IP AddressSubmitter IP address
User AgentSubmitter user agent string
Testtrue if this was a test submission
Spamtrue if TorchWarden flagged this as spam
Spam ScoreNumeric spam score
[field]One column per form field, sorted alphabetically

Nested objects are flattened with dot notation: address.city, address.zip. Values that begin with =, +, -, or @ are prefixed with a single quote to prevent spreadsheet formula injection.

Exporting from the dashboard

To export without code, go to your form’s Submissions page in the dashboard and click Export CSV. See Export Submissions for full instructions.

Last updated on