{"id":2066,"date":"2024-03-14T17:48:43","date_gmt":"2024-03-14T17:48:43","guid":{"rendered":"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/?page_id=2066"},"modified":"2026-01-13T21:02:50","modified_gmt":"2026-01-13T21:02:50","slug":"getting-form-responses","status":"publish","type":"page","link":"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/getting-form-responses\/","title":{"rendered":"Getting form responses"},"content":{"rendered":"\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>There are two ways to retrieve form submissions from GC Forms:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><a href=\"#h-2-downloading-responses-from-gc-forms\"><strong>Downloading<\/strong> responses from GC Forms<\/a><\/li>\n\n\n\n<li><a href=\"#h-3-integrating-the-data-retrieval-api\">Using the GC Forms data retrieval <strong>API<\/strong><\/a><\/li>\n<\/ol>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Note: <\/strong>The data delivery option to receive responses by email was phased out on June 11, 2025. However, you can now opt in to getting email notifications when  new responses are available in Settings.<\/p>\n<\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-2-downloading-responses-from-gc-forms\">1. Downloading responses from GC Forms<\/h2>\n\n\n\n<p>GC Forms can hold and store form responses submitted by people who fill out forms, however only temporarily, as departments and agencies have ultimate custody and control of their forms\u2019 data. As such, when the form response delivery option is set to \u201cDownload responses from GC Forms\u201d, responses must be retrieved from GC Forms within 45 days of receiving a submission. This response delivery method also allows for multiple account holders to access responses, and offers multiple response format options (HTML, CSV, JSON).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-to-download-form-responses\">To download form responses:<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Sign in to&nbsp;<a href=\"https:\/\/forms-formulaires.alpha.canada.ca\/\">GC Forms<\/a>.<\/li>\n\n\n\n<li>In&nbsp;<a href=\"https:\/\/forms-formulaires.alpha.canada.ca\/en\/forms\/all\">Forms<\/a>, go to the form for which you want to get responses.<\/li>\n\n\n\n<li>Select \u201cResponses page\u201d.&nbsp;<\/li>\n\n\n\n<li>If responses have been submitted, they will appear in the &#8220;New&#8221; tab.&nbsp;\n<ul class=\"wp-block-list\">\n<li>You should download responses within 15 days.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Select all responses and \u201cDownload selected\u201d. \n<ul class=\"wp-block-list\">\n<li>You can download up to 150 responses at a time. Your browser may initially block the attempt to download multiple files \u2014 this can be changed in your browser&#8217;s settings.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Choose the format of responses (HTML, CSV, or JSON)\n<ul class=\"wp-block-list\">\n<li>If you&#8217;re looking for a spreadsheet with multiple responses, CSV is likely the option you&#8217;re looking for.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Choose where responses should be saved on your computer. \n<ul class=\"wp-block-list\">\n<li>Consider where responses should be saved based on your department or agency&#8217;s information management policies and processes.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Responses will be moved to the &#8220;Downloaded&#8221; tab.<\/li>\n\n\n\n<li>Next, you will have 15 more days to sign off on the removal of responses.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-to-sign-off-on-the-removal-of-form-responses\"><strong>To sign off on the removal of form responses:<\/strong><\/h3>\n\n\n\n<p>We ask that you confirm having downloaded responses and approve them for removal from GC Forms. Having responses in GC Forms for more than 30 days may lead to account restrictions.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the responses and ensure the content reflects a genuine form response.<\/li>\n\n\n\n<li>Open the receipt file (receipt-recu.html) that was also downloaded.&nbsp;<\/li>\n\n\n\n<li>Select the &#8220;Copy all receipt codes&#8221; button in the receipt file. <\/li>\n\n\n\n<li>Go to the &#8220;Downloaded&#8221; tab.<\/li>\n\n\n\n<li>Select the \u201cSign off on removal with receipt codes\u201d button.\n<ul class=\"wp-block-list\">\n<li>You can sign off on up to 150 responses at a time. <\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Paste receipt codes to verify that responses were downloaded successfully.<\/li>\n\n\n\n<li>Submit receipt codes. Responses will be moved to the &#8220;Signed off for removal&#8221; tab.\n<ul class=\"wp-block-list\">\n<li>If you encounter a problem with a specific response, select &#8220;Report a problem&#8221;.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<div class=\"wp-block-buttons is-layout-flex wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link wp-element-button\" href=\"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/monitoring-overdue-responses\/\">Learn more about overdue responses<\/a><\/div>\n<\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-3-integrating-the-data-retrieval-api\">2. Integrating the data retrieval API<\/h2>\n\n\n\n<p>GC Forms has an application programming interface (API) that can be used to retrieve form responses programmatically. This data retrieval method offers a more efficient and scalable way to collect high volumes of form responses with machine-to-machine connections.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-what-you-ll-need-to-use-the-api\"><strong>What you&#8217;ll need to use the API<\/strong><\/h3>\n\n\n\n<p>With help from developers, you might be able to connect what&#8217;s submitted to GC Forms to your department&#8217;s web application or back-office system.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Infrastructure\/software development resources<\/strong> able to set up the API integration and craft HTTP requests to reach an external API endpoint (outside of departmental firewall).<\/li>\n\n\n\n<li><strong>A form in GC Forms<\/strong> to retrieve responses from a specific form.<\/li>\n\n\n\n<li><strong>An API key and OAuth access token<\/strong> to authenticate and securely access data.<\/li>\n\n\n\n<li><strong>A target system <\/strong>where you plan on receiving form submission data that can accept or parse responses in a structured JSON format.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-set-up-the-api-integration\">Set up the API integration<\/h3>\n\n\n\n<p>To test our API and see if the programmatic delivery of form submissions by calling an API endpoint could work for you, consult our technical documentation for developers.<\/p>\n\n\n\n<div class=\"wp-block-buttons is-layout-flex wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link wp-element-button\" href=\"https:\/\/cds-snc.github.io\/forms-api\/\">Go to API documentation<\/a><\/div>\n<\/div>\n\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-group has-background\" style=\"background-color:#5c4ea2\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\">\n<h2 class=\"wp-block-heading has-text-align-center has-white-color has-text-color has-link-color wp-elements-7d5a092a42fd10f23616edc960f11755\" id=\"h-didn-t-find-what-you-re-looking-for\">Didn&#8217;t find what you&#8217;re looking for?<\/h2>\n\n\n\n<div class=\"wp-block-buttons is-content-justification-center is-layout-flex wp-container-26 wp-block-buttons-is-layout-flex\">\n   <div class=\"wp-block-button is-style-outline has-text-align-center has-custom-font-size has-regular-font-size\" style=\"font-style:normal;font-weight:400\">\n      <a href=\"https:\/\/forms-formulaires.alpha.canada.ca\/en\/form-builder\/support\" target=\"_blank\" aria-labelledby=\"Contact the support team\" class=\"wp-block-button__link has-primary-blue-color has-white-background-color has-text-color has-background wp-element-button\" style=\"margin-top:16px;border-radius:6px;padding-top:6px;padding-right:16px;padding-bottom:6px;padding-left:16px\" rel=\"noopener\">Contact the support team<img decoding=\"async\" src=\"https:\/\/articles.alpha.canada.ca\/uploads\/sites\/11\/2023\/09\/external-icon-1.svg\" style=\"margin-left: 8px;height:20px;width:20px\" alt=\"\" aria-hidden=\"true\"><\/a>\n   <\/div>\n<\/div>\n<\/br>\n<\/div><\/div>\n","protected":false},"excerpt":{"rendered":"<p>There are two ways to retrieve form submissions from GC Forms: Note: The data delivery option to receive responses by email was phased out on June 11, 2025. However, you can now opt in to getting email notifications when new responses are available in Settings. 1. Downloading responses from GC Forms GC Forms can hold\u2026 <a class=\"read-more\" href=\"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/getting-form-responses\/\">Read more<span class=\"wb-sl\"> of Getting form responses<\/span><\/a><\/p>\n","protected":false},"author":235,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2066","page","type-page","status-publish","hentry"],"slug_en":"getting-form-responses","slug_fr":"obtenir-les-reponses-aux-formulaires","id_en":2066,"id_fr":2165,"lang":"en","_links":{"self":[{"href":"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/wp-json\/wp\/v2\/pages\/2066","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/wp-json\/wp\/v2\/users\/235"}],"replies":[{"embeddable":true,"href":"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/wp-json\/wp\/v2\/comments?post=2066"}],"version-history":[{"count":29,"href":"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/wp-json\/wp\/v2\/pages\/2066\/revisions"}],"predecessor-version":[{"id":3304,"href":"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/wp-json\/wp\/v2\/pages\/2066\/revisions\/3304"}],"wp:attachment":[{"href":"https:\/\/articles.alpha.canada.ca\/forms-formulaires\/wp-json\/wp\/v2\/media?parent=2066"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}