POST
/
open
/
forms
/
{id}
/
submissions
/
export
curl --request POST \
  --url https://api.opnform.com/open/forms/{id}/submissions/export \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "columns": {}
}'

Export Submissions (CSV)

Download a CSV file containing submissions for the specified form.

Authentication & Scope

Requires forms-read ability.

Request

POST /open/forms/{id}/submissions/export HTTP/1.1
Host: api.opnform.com
Content-Type: application/json
Authorization: Bearer <token>

Path Parameters

ParameterTypeDescription
idnumberNumeric ID of the form.

Body Parameters

FieldTypeRequiredDescription
columnsobjectYesKeys are field IDs (or created_at); values are booleans indicating whether to include the column in the export.

Example payload exporting two fields and the created_at timestamp:

{
  "columns": {
    "field_name": true,
    "field_email": true,
    "created_at": true
  }
}

Response

200 OK – Returns a CSV file download. The response’s Content-Type will be text/csv and include the Content-Disposition header.

403 Forbidden – The token lacks forms-read or you don’t have access.

Authorizations

Authorization
string
header
required

Personal Access Token

Path Parameters

id
number
required

Body

application/json

Response

200

CSV File