Submissions API

This document describes how student submissions can be exported from Inspera Assessment using APIs.

Submissions can be downloaded both for a test or a single candidate (student). Both export options are described here. 



General information

Export of submissions is done as asynchronous download, both for export of test submissions and export of single candidate submission.

The first call to the submissions APIs will schedule generation of an export and upload it to an internal S3 bucket. Future calls have to include a jobId and will return the progress of the job and the status, as well as a pre-signed, temporary download url for the export once the export is finished. This url will remain valid for the lifetime of the access token used (1 hour from generating the token).

If webhooks are used for machine - to - machine integration, subscription to event "submissions_export_finished" will indicate that export is finished and will return a pre-assigned URL where submissions can be downloaded from.



APIs for submission download


Test submissions download:

Order submission export: https://ias.inspera.no/apidoc/#/test/getSubmissions5

Check status on export and get download URL: https://ias.inspera.no/apidoc/#/test/getSubmissions4

Student submission download:

Order submission export for one student on a specific test:  https://ias.inspera.no/apidoc/#/candidates/getSubmissions3

Check status on export and get download URL: https://ias.inspera.no/apidoc/#/candidates/submissionsDownload



Data model


You can find the data model for the submissions export json here.