Obtaining Atomic Assessments Score Data using Submission Webhooks

When an assessment is completed on the Atomic Assessments platform, the Submission Webhook feature can send a detailed JSON payload to an external system. This payload provides comprehensive information about the assessment attempt, including student performance, question responses, and overall session deta.

Atomic Assessments provides the following three ways for customers to retrieve student assessment submission score data:

Atomic Assessments Webhooks

Each time an assessment submission is scored, Atomic Assessments sends a JSON payload to a REST webhook endpoint. The JSON payload contains:

• Metadata of the assessment, student, and attempt.

• The list of questions in the assessment, content of the questions, and tags applied to the questions.

• Scores for each question.

• Outcome sub-scores if outcome tags or standards have been applied to questions.

Example Payload Structure

• Here's an example of the JSON payload structure

• Here’s a JSON schema describing the structure

• Key Points to Note:

  • General Information: Provides overall details about the attempt, including timestamps and student information.
  • Session Details: Contains information about the student's interaction with the assessment, including scores, duration, and responses to individual questions.
  • Activity Information: Provides details about the activity attempted including the name of the activity, its unique reference, and all the items within that activity.
  • Item Groups (Optional): If configured, this section provides hierarchical scoring information based on a Learnosity tag hierarchy.

The advantage of this approach is it provides the most up-to-date score data possible. In addition the payload includes student and LMS information such as the student’s SIS ID and the LTI Context ID, whereas retrieving the data using Learnosity Data APIs would require obtaining that data from the LMS and connecting it together with the data retrieved from Learnosity.

• In order to set this up, a customer must set up an endpoint and send the URL to Atomic Jolt and the customer’s Atomic Assessments account must be configured to use it.

• A customer must also provide the credentials needed to authenticate with the endpoint. The authentication methods supported include:

  • HMAC

• • Shared secret token

• Atomic Jolt can add support for additional authentication methods as part of a services contract to configure sending score data.

If Atomic Assessments attempts to send the payload and it is unsuccessful, it will reattempt three times during the following minute and then stop trying.

Atomic Assessments Scores API

Atomic Assessments provides an API that you can call to retrieve a list of assessment score payloads that have been sent in a specified time period. You can call this API to verify that you have received all of the assessment scores. If you identify scores that have been missed, you can call the API with a list of scores to retrieve. This API is intended to be used in conjunction with the webhook for auditing purposes, not to be used in isolation.

Learnosity APIs

Atomic Assessments is built on top of the Learnosity platform. As a result, Atomic Assessments assessment submissions and scores are stored in Learnosity. You can retrieve submission and score data by calling Learnosity Data APIs.

For information about the Learnosity Data APIs, see: https://help.learnosity.com/hc/en-us/articles/16458089700381-Data-API

• For information about the Learnosity Data APIs, see: https://help.learnosity.com/hc/en-us/articles/16458089700381-Data-API
• In order to call Learnosity APIs, you must pass a Learnosity Consumer Key and a hash calculated using a Learnosity Consumer Secret. For information on setting up Learnosity Consumer credentials, see: https://help.learnosity.com/hc/en-us/articles/360001767178-First-Time-Setup-for-Your-API-Consumer
• Only customers that have licensed a premium item bank can call Learnosity APIs.

The advantage of calling Learnosity APIs is that it gives you access to all data that Learnosity stores including information that may not be available via the Atomic Assessments webhooks and APIs. The disadvantage is that you will not have access to data that is stored only in Atomic Assessments’ database such as student names and LMS course ids.