Export a form's submissions as CSV
Returns the submissions of one form as a CSV file (text/csv), one row per submission. The columns are id, formId, pagePath, replyTo and createdAt (Unix ms), then one column per field name the form has collected, in alphabetical order. Cells are quoted as RFC 4180 describes and rows end with CRLF.
An export holds at most 2,000 submissions. When it hits that limit the response carries x-form-export-truncated: true; narrow it with fromMs, toMs, and q and export again. form is required. Optional q uses the same search contract as the list endpoint. Submissions hold visitors' personal data, so this needs at least the editor role on the site. A viewer gets 403 forbidden_role.
Request
- Base URL: https://api.dotsy.ai
- URL: https://api.dotsy.ai/api/v1/sites/{slug}/form-submissions/export.csv
- Auth: one of:
- HTTP bearer
- HTTP bearer
Path parameters
Site slug or site id (UUID). An old slug answers 301/308 and a site id 307 to the canonical slug path.
Query parameters
Form id, as wired on the page, for example contact. Omit to list every form's submissions newest first.
Only submissions made at or after this time, Unix ms.
Only submissions made at or before this time, Unix ms.
Search text, case-insensitive. Matches the reply-to email and any field value (substring). On graduated sites the SQL list path applies when q is omitted; with q set, search scans up to 5,000 rows.
Response
The CSV file.
Changes
No recorded changes to this operation across all 1 revision of this API.