Obtaining Atomic Assessments Score Data

Atomic Assessments provides webhooks and APIs for customers to retrieve student assessment submission score data.

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

1. 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. 
   • For a detailed description of the payload that Atomic Assessments sends, see: Atomic Assessments Submission Payload Format

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:
  1.  HMAC
  2. 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.

1. 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.
   • Note: The Scores API is not yet implemented. Atomic Jolt has committed to implement it by the March 2025 release.
2. 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 
   • 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.