List submissions
Submissions of one form with their answers, newest first.
MCP tool jotform_read → list_submissions
read
Returns the submissions of a form with ID, date and the answers keyed by field ID. Filter by date range or by text in an answer. Archived submissions are left out unless you ask for them. Pages hold up to 100 submissions; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| form_id string required | string | Form ID from list_forms. |
| created_from string | string | Only submissions created on or after this date, ISO 8601. |
| created_to string | string | Only submissions created before this date, ISO 8601. |
| query string | string | Only submissions where an answer contains this text. |
| archived boolean | boolean | true to list the archive instead of the inbox. Default: false. |
| limit integer | integer | 1 to 100. Default: 25. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "jotform_read",
"arguments": {
"operation": "list_submissions",
"arguments": {
"form_id": "form_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"submissions": [
{
"submission_id": "6012345678901234567",
"created_at": "2026-10-09T14:21:00Z",
"answers": {
"3": "Jordan Ellis",
"7": "jordan.ellis@gmial.com",
"9": "Standard"
}
},
{
"submission_id": "6012345678901234555",
"created_at": "2026-10-08T09:03:00Z",
"answers": {
"3": "Ava Kim",
"7": "ava.kim@example.com",
"9": "VIP"
}
}
],
"next_cursor": null
},
"isError": false
}