GET
/forms/{formId}/submissionsList a form's submissions
Lists submissions for a specific form, with the newest submissions first. Use formId to select the form and search to filter results; spam and deleted submissions are excluded, and limit and startingAfter control pagination.
formIdstringrequired
The identifier of the form whose submissions to list. Must contain at least one character.
limitintegeroptional
Maximum number of submissions to return. Must be between 1 and 100. Defaults to 25 when omitted.
startingAfterstringoptional
Cursor for the next page of results, using the `nextCursor` value from the previous response.
searchstringoptional
Search term used to filter submissions. Must contain 1 to 256 characters when supplied.
200Returns a page containing submission objects in `data`, a `hasMore` indicator, and a `nextCursor` for retrieving the next page. Each submission includes its ID, form ID, submitted data, and creation timestamp; spam and deleted submissions are excluded.
dataarray<object>required
hasMorebooleanrequired
nextCursorstringrequired
400Returned when the request is malformed or fails validation.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
401Returned when the token is missing, malformed, revoked, or expired.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
403Returned when the token lacks the scope required for this operation, the workspace is not upgraded, or a limit has been reached.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
404Returned when the resource does not exist.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
429Returned when the caller is rate limited and should retry later.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
500Returned when an error occurs on the server.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
Error handling
A 400 is returned when the request is malformed or fails validation; a 401 when the token is missing, malformed, revoked, or expired; a 403 when the token lacks the required scope, the workspace is not upgraded, or a limit is reached; a 404 when the resource does not exist; a 429 when the caller is rate limited; and a 500 when an error occurs on the server. The formId path parameter must contain at least one character, limit must be between 1 and 100, and search must contain 1 to 256 characters when supplied.