List submissions
Submissions of one form with their answers, newest first.
MCP tool formstack_read → list_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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "formstack_read",
"arguments": {
"operation": "list_submissions",
"arguments": {
"form_id": "form_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"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
},
"isError": false
}