/forms/{formId}/submissions

get

https://www.formstack.com/api/v2025/forms/{formId}/submissions

Retrieve a paginated list of submissions for a specific form

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

formId

integer

required

The unique identifier of the form to retrieve submissions from

Query Params

pageNumber

integer | null

≥ 1

Page number for pagination (starting from 1)

pageSize

integer | null

10 to 500

Defaults to 50

Maximum number of submissions to return per page (default: 25, max: 100)

order

string | null

enum

Defaults to ASC

Sort order for results (ASC for ascending, DESC for descending)

Allowed:

keyword

string | null

Search term to filter submissions by content across all fields

minTime

string | null

Return submissions created on or after this date/time (format: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS in Eastern Time)

maxTime

string | null

Return submissions created on or before this date/time (format: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS in Eastern Time)

array of objects | null

Search specific fields by ID and value. Use array format in query string: search[0][fieldId]=111&search[0][value]=foo&search[1][fieldId]=112&search[1][value]=bar (supports up to 10 search criteria)

data

string | null

Include field data in the response (true/false)

expandData

string | null

Include expanded field data with parsed values (true/false)

prettyName

string | null

Include a human-readable name for each submission based on name or email fields (true/false)

dataFormat

string | null

enum

Defaults to legacy

Shape of the 'data' field: 'legacy' (default, object keyed by field id) or 'standardized' (array of field objects matching GET /submissions/{id})

Allowed:

Headers

X-FS-Encryption-Password

string

Required when form has encryption enabled and data=true or prettyName=true. The encryption password used to decrypt submission data

Responses

401

Unauthorized - Encryption password required or invalid

403

Forbidden

500

Internal server error

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK