Looking for real-time submissions? The most efficient way to instantly retrieve new
submissions is by using a webhook. This allows you to receive
data as soon as a form is submitted, without needing to poll the API.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tally Developer Docs","colors":{"primary":"#000","light":"#559BFA","dark":"#0170D7"},"logo":{"light":"https://mintcdn.com/tally/Lx32mG3X3piCKx5e/images/logo/light.svg?fit=max\u0026auto=format\u0026n=Lx32mG3X3piCKx5e\u0026q=85\u0026s=cd40b335ca868409ff942f2762879cae","dark":"https://mintcdn.com/tally/Lx32mG3X3piCKx5e/images/logo/dark.svg?fit=max\u0026auto=format\u0026n=Lx32mG3X3piCKx5e\u0026q=85\u0026s=2d26351e2ae668d00f3350d2f8154080"},"favicon":"https://mintcdn.com/tally/ZsljAhSrsTiaKklr/images/favicon.ico?fit=max\u0026auto=format\u0026n=ZsljAhSrsTiaKklr\u0026q=85\u0026s=0248d1609351a722b90aee3c7fbe8b3f","navbar":{"links":[{"href":"https://tally.so/support","label":"Support"},{"href":"https://tally.so/help","label":"Help Center"}],"primary":{"type":"button","label":"Create API key","href":"https://tally.so/settings/api-keys"}},"footer":{"socials":{"github":"https://github.com/tallyforms","x":"https://twitter.com/tallyforms","reddit":"https://www.reddit.com/r/tallyforms","linkedin":"https://linkedin.com/company/tallyforms","instagram":"https://instagram.com/tallyforms","bluesky":"https://bsky.app/profile/tally.so","threads":"https://threads.net/@tallyforms"}},"integrations":{"plausible":{"domain":"developers.tally.so"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tally","hasAudioNarration":false,"actualSubdomain":"tally","customDomains":["developers.tally.so"],"gitSource":{"type":"github","owner":"tallyforms","repo":"tally","deployBranch":"develop","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af6ca202460719ed74c2824","clientVersion":"0.0.4124","searchFilterCounts":[{"language":"default","tag":"API Reference","count":40},{"language":"default","tag":"Block Schema Reference","count":39},{"language":"default","tag":"Blocks","count":39},{"language":"default","tag":"Forms","count":14},{"language":"default","tag":"Workspaces","count":9},{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"Widgets","count":8},{"language":"default","tag":"Getting started","count":6},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Analytics","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/forms/submissions/list","slug":"/api-reference/endpoint/forms/submissions/list","pageMetadata":{"title":"Listing submissions","openapi":"GET /forms/{formId}/submissions","description":"Returns a paginated list of form submissions with their responses.","href":"/api-reference/endpoint/forms/submissions/list"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns a paginated list of form submissions with their responses.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Tip}=_components;if(!Tip)_missingMdxReference(`Tip`,true);return _jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(`b`,{children:`Looking for real-time submissions?`}),` The most efficient way to instantly retrieve new\nsubmissions is by using a `,_jsx(_components.a,{href:`https://tally.so/help/webhooks`,children:`webhook`}),`. This allows you to receive\ndata as soon as a form is submitted, without needing to poll the API.`]})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Listing submissions","openapi":"GET /forms/{formId}/submissions","description":"Returns a paginated list of form submissions with their responses.","href":"/api-reference/endpoint/forms/submissions/list"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"List form submissions","description":"Returns a paginated list of form submissions with their responses.","tags":["Forms"],"parameters":["bbabc330-a7bb-4751-8fc7-3e3a99a5d104","5ff4cea6-53c1-4cc5-843a-a7775b36a829","e6b98f9b-6392-40de-bbb3-a26b6792f22b","5302aec9-5d33-4640-b4d6-b59b9bb01bae","3bbd4bb7-ee21-47e2-a1d6-d085a4a252bd","74a31862-9f8f-4f3b-afed-c285c0f54691","81e84e99-e0ca-4a66-8254-b098d560f09d"],"responses":{"200":"bb37b0f4-f355-4768-8e9b-4436d156632c","401":"ad483be8-f456-4d0e-beb5-87a8612c9975","403":"2920eb25-bdb0-4263-8bc1-459e3397775c","404":"cd54101e-dd3c-418c-9d6b-72f97bab14b0"},"security":["ece94890-cc8a-40fc-bc63-af38a2a170c1"],"method":"get","type":"path","servers":["b597cc29-7408-4ad2-93ef-f2caeb455043"],"path":"/forms/{formId}/submissions","baseUrlOptions":["https://api.tally.so"],"title":"List form submissions","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"bbabc330-a7bb-4751-8fc7-3e3a99a5d104":{"name":"formId","in":"path","required":true,"description":"The ID of the form","schema":{"type":"string","isRequired":true,"description":"The ID of the form","uniqueKey":"","typeLabel":"string"}},"5ff4cea6-53c1-4cc5-843a-a7775b36a829":{"name":"page","in":"query","required":false,"description":"Page number for pagination (default: 1)","schema":{"type":"integer","minimum":1,"isRequired":false,"description":"Page number for pagination (default: 1)","uniqueKey":"","typeLabel":"integer"}},"e6b98f9b-6392-40de-bbb3-a26b6792f22b":{"name":"filter","in":"query","required":false,"description":"Filter submissions by status","schema":{"type":"string","enum":["all","completed","partial"],"isRequired":false,"description":"Filter submissions by status","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"5302aec9-5d33-4640-b4d6-b59b9bb01bae":{"name":"startDate","in":"query","required":false,"description":"Filter submissions submitted on or after this date (ISO 8601 format)","schema":{"type":"string","format":"date-time","isRequired":false,"description":"Filter submissions submitted on or after this date (ISO 8601 format)","uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"3bbd4bb7-ee21-47e2-a1d6-d085a4a252bd":{"name":"endDate","in":"query","required":false,"description":"Filter submissions submitted on or before this date (ISO 8601 format)","schema":{"type":"string","format":"date-time","isRequired":false,"description":"Filter submissions submitted on or before this date (ISO 8601 format)","uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"74a31862-9f8f-4f3b-afed-c285c0f54691":{"name":"afterId","in":"query","required":false,"description":"Get submissions that came after a specific submission ID","schema":{"type":"string","isRequired":false,"description":"Get submissions that came after a specific submission ID","uniqueKey":"","typeLabel":"string"}},"81e84e99-e0ca-4a66-8254-b098d560f09d":{"name":"limit","in":"query","required":false,"description":"Number of submissions to return per page (default: 50, max: 500)","schema":{"type":"integer","minimum":1,"maximum":500,"default":50,"isRequired":false,"description":"Number of submissions to return per page (default: 50, max: 500)","uniqueKey":"","typeLabel":"integer"}}},"responses":{"bb37b0f4-f355-4768-8e9b-4436d156632c":{"description":"List of form submissions","content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"number","description":"Current page number","uniqueKey":"page","typeLabel":"number"},"limit":{"type":"number","description":"Number of submissions per page","uniqueKey":"limit","typeLabel":"number"},"hasMore":{"type":"boolean","description":"Whether there are more pages available","uniqueKey":"hasMore","typeLabel":"boolean"},"totalNumberOfSubmissionsPerFilter":{"type":"object","properties":{"all":{"type":"number","description":"Total number of all submissions","uniqueKey":"totalNumberOfSubmissionsPerFilter.all","typeLabel":"number"},"completed":{"type":"number","description":"Total number of completed submissions","uniqueKey":"totalNumberOfSubmissionsPerFilter.completed","typeLabel":"number"},"partial":{"type":"number","description":"Total number of partial submissions","uniqueKey":"totalNumberOfSubmissionsPerFilter.partial","typeLabel":"number"}},"uniqueKey":"totalNumberOfSubmissionsPerFilter","typeLabel":"object"},"questions":{"type":"array","description":"List of form questions","items":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"questions.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["FORM_TITLE","TEXT","LABEL","TITLE","HEADING_1","HEADING_2","HEADING_3","DIVIDER","PAGE_BREAK","IMAGE","EMBED","EMBED_VIDEO","EMBED_AUDIO","QUESTION","MATRIX","INPUT_TEXT","INPUT_NUMBER","INPUT_EMAIL","INPUT_LINK","INPUT_PHONE_NUMBER","INPUT_DATE","INPUT_TIME","TEXTAREA","FILE_UPLOAD","LINEAR_SCALE","RATING","HIDDEN_FIELDS","MULTIPLE_CHOICE_OPTION","CHECKBOX","DROPDOWN_OPTION","RANKING_OPTION","MULTI_SELECT_OPTION","PAYMENT","SIGNATURE","MATRIX_ROW","MATRIX_COLUMN","CONDITIONAL_LOGIC","CALCULATED_FIELDS","CAPTCHA","RESPONDENT_COUNTRY"],"uniqueKey":"questions.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"title":{"type":"string","uniqueKey":"questions.items.[INDEX].title","typeLabel":"string"},"isTitleModifiedByUser":{"type":"boolean","uniqueKey":"questions.items.[INDEX].isTitleModifiedByUser","typeLabel":"boolean"},"formId":{"type":"string","uniqueKey":"questions.items.[INDEX].formId","typeLabel":"string"},"isDeleted":{"type":"boolean","uniqueKey":"questions.items.[INDEX].isDeleted","typeLabel":"boolean"},"numberOfResponses":{"type":"integer","uniqueKey":"questions.items.[INDEX].numberOfResponses","typeLabel":"integer"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"questions.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"questions.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"fields":{"type":"array","items":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid","uniqueKey":"questions.items.[INDEX].fields.items.[INDEX].uuid","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["FORM_TITLE","TEXT","LABEL","TITLE","HEADING_1","HEADING_2","HEADING_3","DIVIDER","PAGE_BREAK","IMAGE","EMBED","EMBED_VIDEO","EMBED_AUDIO","QUESTION","MATRIX","INPUT_TEXT","INPUT_NUMBER","INPUT_EMAIL","INPUT_LINK","INPUT_PHONE_NUMBER","INPUT_DATE","INPUT_TIME","TEXTAREA","FILE_UPLOAD","LINEAR_SCALE","RATING","HIDDEN_FIELDS","MULTIPLE_CHOICE_OPTION","CHECKBOX","DROPDOWN_OPTION","RANKING_OPTION","MULTI_SELECT_OPTION","PAYMENT","SIGNATURE","MATRIX_ROW","MATRIX_COLUMN","CONDITIONAL_LOGIC","CALCULATED_FIELDS","CAPTCHA","RESPONDENT_COUNTRY"],"uniqueKey":"questions.items.[INDEX].fields.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"blockGroupUuid":{"type":"string","format":"uuid","uniqueKey":"questions.items.[INDEX].fields.items.[INDEX].blockGroupUuid","typeLabel":"string\u003cuuid>"},"title":{"type":"string","uniqueKey":"questions.items.[INDEX].fields.items.[INDEX].title","typeLabel":"string"}},"uniqueKey":"questions.items.[INDEX].fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"questions.items.[INDEX].fields","typeLabel":"object[]"}},"uniqueKey":"questions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"questions","typeLabel":"object[]"},"submissions":{"type":"array","description":"List of form submissions","items":{"type":"object","properties":{"id":{"type":"string","description":"Submission ID","uniqueKey":"submissions.items.[INDEX].id","typeLabel":"string"},"formId":{"type":"string","description":"Form ID","uniqueKey":"submissions.items.[INDEX].formId","typeLabel":"string"},"isCompleted":{"type":"boolean","description":"Whether the submission is completed","uniqueKey":"submissions.items.[INDEX].isCompleted","typeLabel":"boolean"},"submittedAt":{"type":"string","format":"date-time","description":"When the submission was submitted","uniqueKey":"submissions.items.[INDEX].submittedAt","typeLabel":"string\u003cdate-time>"},"locale":{"oneOf":[{"type":"string","description":"Language code the respondent filled the form in, e.g. 'nl', 'pt-BR' or 'zh-CN'. Null when not known, for example on forms without translations or on older submissions.","uniqueKey":"submissions.items.[INDEX].locale.oneOf.0","typeLabel":"string"},{"type":"null","description":"Language code the respondent filled the form in, e.g. 'nl', 'pt-BR' or 'zh-CN'. Null when not known, for example on forms without translations or on older submissions.","uniqueKey":"submissions.items.[INDEX].locale.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].locale","typeLabel":"string | null"},"previewUrl":{"type":"string","format":"uri","description":"Signed URL to view the submission in a browser. Includes an access token, no expiry.","uniqueKey":"submissions.items.[INDEX].previewUrl","typeLabel":"string\u003curi>"},"pdfUrl":{"type":"string","format":"uri","description":"Signed URL to download the submission as a PDF. Includes an access token, no expiry.","uniqueKey":"submissions.items.[INDEX].pdfUrl","typeLabel":"string\u003curi>"},"responses":{"type":"array","description":"List of responses to form questions. Note: Only questions that have been answered will appear in this array.","items":{"type":"object","properties":{"id":{"type":"string","description":"Response ID","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].id","typeLabel":"string"},"formId":{"type":"string","description":"Form ID","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].formId","typeLabel":"string"},"questionId":{"type":"string","description":"Question ID","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].questionId","typeLabel":"string"},"respondentId":{"type":"string","description":"Respondent ID","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].respondentId","typeLabel":"string"},"sessionUuid":{"type":"string","format":"uuid","description":"Session UUID","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].sessionUuid","typeLabel":"string\u003cuuid>"},"answer":{"oneOf":[{"type":"string","description":"The answer value for this question. Type varies based on question type.","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].answer.oneOf.0","typeLabel":"string"},{"type":"number","description":"The answer value for this question. Type varies based on question type.","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].answer.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"The answer value for this question. Type varies based on question type.","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].answer.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].answer.oneOf.3.items.[INDEX]","typeLabel":"any"},"description":"The answer value for this question. Type varies based on question type.","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].answer.oneOf.3","typeLabel":"any[]"},{"type":"object","description":"The answer value for this question. Type varies based on question type.","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].answer.oneOf.4","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].answer.oneOf.5","typeLabel":"null"}],"isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].answer","typeLabel":"string | number | boolean | any[] | object | null"},"createdAt":{"type":"string","format":"date-time","description":"When the response was created","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"When the response was last updated","isRequired":true,"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"submissionId":{"oneOf":[{"type":"string","description":"Submission ID","uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].submissionId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Submission ID","uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].submissionId.oneOf.1","typeLabel":"null"}],"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].submissionId","typeLabel":"string | null"},"formattedAnswer":{"type":"string","description":"Formatted answer (e.g., for number inputs with custom formatting)","uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX].formattedAnswer","typeLabel":"string"}},"required":["id","formId","questionId","respondentId","sessionUuid","answer","createdAt","updatedAt"],"uniqueKey":"submissions.items.[INDEX].responses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"submissions.items.[INDEX].responses","typeLabel":"object[]"}},"uniqueKey":"submissions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"submissions","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"page":123,"limit":123,"hasMore":true,"totalNumberOfSubmissionsPerFilter":{"all":123,"completed":123,"partial":123},"questions":[{"id":"\u003cstring>","type":"FORM_TITLE","title":"\u003cstring>","isTitleModifiedByUser":true,"formId":"\u003cstring>","isDeleted":true,"numberOfResponses":123,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","fields":[{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","type":"FORM_TITLE","blockGroupUuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","title":"\u003cstring>"}]}],"submissions":[{"id":"\u003cstring>","formId":"\u003cstring>","isCompleted":true,"submittedAt":"2023-11-07T05:31:56Z","locale":"\u003cstring>","previewUrl":"\u003cstring>","pdfUrl":"\u003cstring>","responses":[{"id":"\u003cstring>","formId":"\u003cstring>","questionId":"\u003cstring>","respondentId":"\u003cstring>","sessionUuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","answer":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","submissionId":"\u003cstring>","formattedAnswer":"\u003cstring>"}]}]}}},"exampleType":"generated"}},"exampleType":"generated"},"ad483be8-f456-4d0e-beb5-87a8612c9975":{"description":"Unauthorized","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2920eb25-bdb0-4263-8bc1-459e3397775c":{"description":"Forbidden","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"cd54101e-dd3c-418c-9d6b-72f97bab14b0":{"description":"Form not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"ece94890-cc8a-40fc-bc63-af38a2a170c1":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"b597cc29-7408-4ad2-93ef-f2caeb455043":{"url":"https://api.tally.so"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"tally","siteName":"Tally Developer Docs","title":"Listing submissions - Tally Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-23T13:40:47.295Z","originalFileLocation":"api-reference/endpoint/forms/submissions/list.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns a paginated list of form submissions with their responses.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tally Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Listing submissions - Tally Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a paginated list of form submissions with their responses.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tally Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.tally.so/api-reference/endpoint/forms/submissions/list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tally.mintlify.site/_mintlify/api/og/v2?division=Forms\u0026amp;title=Listing+submissions\u0026amp;description=Returns+a+paginated+list+of+form+submissions+with+their+responses.\u0026amp;theme=da42082e9f67c51bf4140253\u0026amp;signature=b81140ad8e74afd1973761e1b27beef71c1018c324b8e8b157982ad5426df72d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Listing submissions - Tally Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a paginated list of form submissions with their responses.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tally.mintlify.site/_mintlify/api/og/v2?division=Forms\u0026amp;title=Listing+submissions\u0026amp;description=Returns+a+paginated+list+of+form+submissions+with+their+responses.\u0026amp;theme=da42082e9f67c51bf4140253\u0026amp;signature=b81140ad8e74afd1973761e1b27beef71c1018c324b8e8b157982ad5426df72d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tally Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.tally.so/api-reference/endpoint/forms/submissions/list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/forms/submissions/list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.tally.so/#organization\",\"name\":\"Tally Developer Docs\",\"url\":\"https://developers.tally.so\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tally/Lx32mG3X3piCKx5e/images/logo/light.svg?fit=max\u0026auto=format\u0026n=Lx32mG3X3piCKx5e\u0026q=85\u0026s=cd40b335ca868409ff942f2762879cae\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.tally.so#website\",\"name\":\"Tally Developer Docs\",\"url\":\"https://developers.tally.so\",\"publisher\":{\"@id\":\"https://developers.tally.so/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.tally.so/api-reference/endpoint/forms/submissions/list#webpage\",\"url\":\"https://developers.tally.so/api-reference/endpoint/forms/submissions/list\",\"name\":\"Listing submissions\",\"description\":\"Returns a paginated list of form submissions with their responses.\",\"dateModified\":\"2026-01-23T13:40:47.295Z\",\"isPartOf\":{\"@id\":\"https://developers.tally.so#website\"},\"breadcrumb\":{\"@id\":\"https://developers.tally.so/api-reference/endpoint/forms/submissions/list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.tally.so/api-reference/endpoint/forms/submissions/list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Forms\",\"item\":\"https://developers.tally.so/api-reference/endpoint/forms/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Listing submissions\",\"item\":\"https://developers.tally.so/api-reference/endpoint/forms/submissions/list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.tally.so/api-reference/endpoint/forms/submissions/list#apireference\",\"headline\":\"Listing submissions\",\"name\":\"Listing submissions\",\"description\":\"Returns a paginated list of form submissions with their responses.\",\"url\":\"https://developers.tally.so/api-reference/endpoint/forms/submissions/list\",\"mainEntityOfPage\":{\"@id\":\"https://developers.tally.so/api-reference/endpoint/forms/submissions/list#webpage\"},\"dateModified\":\"2026-01-23T13:40:47.295Z\",\"publisher\":{\"@id\":\"https://developers.tally.so/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.tally.so#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tally Developer Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tally Developer Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/forms/submissions/list.md","siteName":"Tally Developer Docs","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Getting started","pages":[{"title":"Introduction","icon":"rocket","href":"/api-reference/introduction"},{"title":"API keys","icon":"key","href":"/api-reference/api-keys"},{"title":"Versioning","icon":"calendar-check","href":"/api-reference/versioning"},{"title":"Changelog","icon":"list-check","href":"/api-reference/changelog"},{"title":"MCP server","icon":"plug","href":"/api-reference/mcp"}]},{"group":"Users","pages":[{"title":"Fetching user info","openapi":"GET /users/me","href":"/api-reference/endpoint/users/me/get"}]},{"group":"Organizations","pages":[{"title":"Listing users","openapi":"GET /organizations/{organizationId}/users","href":"/api-reference/endpoint/organizations/users/get"},{"title":"Removing users","openapi":"DELETE /organizations/{organizationId}/users/{userId}","href":"/api-reference/endpoint/organizations/users/delete"},{"title":"Listing invites","openapi":"GET /organizations/{organizationId}/invites","href":"/api-reference/endpoint/organizations/invites/get"},{"title":"Creating invites","openapi":"POST /organizations/{organizationId}/invites","href":"/api-reference/endpoint/organizations/invites/post"},{"title":"Cancelling invites","openapi":"DELETE /organizations/{organizationId}/invites/{inviteId}","href":"/api-reference/endpoint/organizations/invites/delete"}]},{"group":"Forms","pages":[{"title":"Listing forms","openapi":"GET /forms","href":"/api-reference/endpoint/forms/list"},{"title":"Creating forms","openapi":"POST /forms","href":"/api-reference/endpoint/forms/post"},{"title":"Fetching forms","openapi":"GET /forms/{formId}","href":"/api-reference/endpoint/forms/get"},{"title":"Updating forms","openapi":"PATCH /forms/{formId}","href":"/api-reference/endpoint/forms/patch"},{"title":"Deleting forms","openapi":"DELETE /forms/{formId}","href":"/api-reference/endpoint/forms/delete"},{"title":"Listing questions","openapi":"GET /forms/{formId}/questions","description":"Returns a list of all questions in a form.","href":"/api-reference/endpoint/forms/questions/list"},{"title":"Listing submissions","openapi":"GET /forms/{formId}/submissions","href":"/api-reference/endpoint/forms/submissions/list"},{"title":"Fetching submissions","openapi":"GET /forms/{formId}/submissions/{submissionId}","description":"Returns a specific form submission with all its responses and the form questions.","href":"/api-reference/endpoint/forms/submissions/get"},{"title":"Deleting submissions","openapi":"DELETE /forms/{formId}/submissions/{submissionId}","href":"/api-reference/endpoint/forms/submissions/delete"},{"group":"Analytics","pages":[{"title":"Metrics","openapi":"GET /forms/{formId}/analytics/metrics","href":"/api-reference/endpoint/forms/analytics/metrics"},{"title":"Visits","openapi":"GET /forms/{formId}/analytics/visits","href":"/api-reference/endpoint/forms/analytics/visits"},{"title":"Submissions","openapi":"GET /forms/{formId}/analytics/submissions","href":"/api-reference/endpoint/forms/analytics/submissions"},{"title":"Dimensions","openapi":"GET /forms/{formId}/analytics/dimensions","href":"/api-reference/endpoint/forms/analytics/dimensions"},{"title":"Drop-off","openapi":"GET /forms/{formId}/analytics/drop-off","href":"/api-reference/endpoint/forms/analytics/drop-off"}]}]},{"group":"Workspaces","pages":[{"title":"Listing workspaces","openapi":"GET /workspaces","href":"/api-reference/endpoint/workspaces/list"},{"title":"Creating workspaces","openapi":"POST /workspaces","href":"/api-reference/endpoint/workspaces/post"},{"title":"Fetching workspaces","openapi":"GET /workspaces/{workspaceId}","href":"/api-reference/endpoint/workspaces/get"},{"title":"Updating workspaces","openapi":"PATCH /workspaces/{workspaceId}","href":"/api-reference/endpoint/workspaces/patch"},{"title":"Deleting workspaces","openapi":"DELETE /workspaces/{workspaceId}","href":"/api-reference/endpoint/workspaces/delete"},{"group":"Folders","pages":[{"title":"Listing folders","openapi":"GET /workspaces/{workspaceId}/folders","href":"/api-reference/endpoint/workspaces/folders/list"},{"title":"Creating folders","openapi":"POST /workspaces/{workspaceId}/folders","href":"/api-reference/endpoint/workspaces/folders/post"},{"title":"Updating folders","openapi":"PATCH /workspaces/{workspaceId}/folders/{id}","href":"/api-reference/endpoint/workspaces/folders/patch"},{"title":"Deleting folders","openapi":"DELETE /workspaces/{workspaceId}/folders/{id}","href":"/api-reference/endpoint/workspaces/folders/delete"}]}]},{"group":"Webhooks","pages":[{"title":"Listing webhooks","openapi":"GET /webhooks","href":"/api-reference/endpoint/webhooks/get"},{"title":"Creating webhooks","openapi":"POST /webhooks","href":"/api-reference/endpoint/webhooks/post"},{"title":"Updating webhooks","openapi":"PATCH /webhooks/{webhookId}","href":"/api-reference/endpoint/webhooks/patch"},{"title":"Deleting webhooks","openapi":"DELETE /webhooks/{webhookId}","href":"/api-reference/endpoint/webhooks/delete"},{"title":"Listing webhook events","openapi":"GET /webhooks/{webhookId}/events","href":"/api-reference/endpoint/webhooks/events/get"},{"title":"Retrying webhook events","openapi":"POST /webhooks/{webhookId}/events/{eventId}","href":"/api-reference/endpoint/webhooks/events/retry"}]}]},{"tab":"Block Schema Reference","pages":[{"title":"Block Schema Reference","href":"/blocks-reference/form-title"}]},{"tab":"Widgets","pages":[{"title":"Widgets","href":"/widgets/introduction"}]},{"tab":"Documentation","pages":[{"title":"Documentation","href":"/documentation/creating-a-form"}]}]},"basePath":"","title":"Listing submissions - Tally Developer Docs","buildId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","deploymentId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CDiBsYGW.js","utils-KF9rPlmF.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C26urKTX.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BdjmJAC1.js","snippetPresets-3IpDBjt3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-D4x_2vvo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BIWdc5Pa.js","shallow-LQqfiMNd.js","getApiPlaygroundDisplay-DryzlOZG.js","CodeSnippet-tcJujU4r.js","CodeSnippets-BHp0nVLL.js","Page-1CZdsdAn.js","getPastedJson-DU-1ayUv.js","icon-CZK2hPr4.js","MethodPill-DOaqmTFC.js","DuplicateIcon-B5-nUxxl.js","createIcon-CDP_U77G.js","DynamicMarkdown-GHvayGOn.js","SectionHeading-BYvpkmUD.js","axios-vUo_bRtp.js","Markdown-uxhlayGT.js","clsx-B35qUV0p.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BvrGG8gU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CAf0yVYe.js"]}