Workflow of the Forms Asynchronous Reporting API

The workflow for the Forms Asynchronous Reporting API includes the following high-level steps.

  1. The client application posts a reporting job to the job queue, specifying the job type REPORT (form data, including contents and information about approvals for the form) or DOCUMENT_EXPORT (only approval information). The client application receives a job ID in response.

  2. The client application polls the job status using the job ID in the API until the job is complete.

  3. When the job is complete, the output is ready for download.

  4. The client application requests the output document, specifying the job ID.

  5. The downloaded ZIP file contains the output as a CSV or JSON file, depending on what was specified in the reporting job.

  6. Optional. The client application requests a list of all submitted reporting jobs for a site, specifying the desired filter.