List submissions
Submissions of one form with their answers, newest first.
GET https://cotlet.dev/api/v1/formstack/forms/{form_id}/submissions
read
Returns the submissions of a form with ID, date, read and favorited flags and the answers keyed by field ID. The view is the one in the Submissions tab: all, read, unread or favorited. The query is the same text search as the search bar. Pass next_cursor back as cursor for the next page. The Submissions tab needs access: without it Formstack shows nothing to read.
Parameters
| Name | Type | Description |
|---|---|---|
| form_id string required | string | Form ID from list_forms. |
| view string | string | all, read, unread or favorited. Default: all. |
| query string | string | Only submissions where an answer contains this text. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/formstack/forms/form_8c41d2/submissions \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("formstack", "list_submissions", {"form_id":"form_8c41d2"})const result = await cotlet.call('formstack', 'list_submissions', {"form_id":"form_8c41d2"});cotlet call formstack list_submissions --data '{"form_id":"form_8c41d2"}'Example response
{
"submissions": [
{
"submission_id": "1128305944",
"submitted_at": "2026-10-21T14:21:00Z",
"read": false,
"favorited": false,
"answers": {
"48211325": "Jordan Ellis",
"48211330": "jordan.ellis@gmial.com",
"48211341": "Vegetarian"
}
},
{
"submission_id": "1128301377",
"submitted_at": "2026-10-20T09:03:00Z",
"read": true,
"favorited": true,
"answers": {
"48211325": "Ava Kim",
"48211330": "ava.kim@example.com",
"48211341": "None"
}
}
],
"next_cursor": null
}