--- title: Obtaining Atomic Assessments Score Data using Submission Webhooks description: Atomic Assessments offers webhooks and APIs for customers to retrieve student assessment submission score data. These are premium features requiring additional license agreements. --- [Skip to content](https://support.atomicjolt.com/knowledgebase/obtaining-atomic-assessments-score-data#main-content) English Show submenu for translations [File a Support Ticket](https://support.atomicjolt.com/knowledgebase/kb-tickets/new?hsLang=en) [Customer Portal](https://support.atomicjolt.com/tickets-view?hsLang=en) ![Atomic Jolt Logo Horiz Small](https://support.atomicjolt.com/hs-fs/hubfs/Atomic%20Jolt%20Logo%20Horiz%20Small.png?width=260&height=95&name=Atomic%20Jolt%20Logo%20Horiz%20Small.png) - [Release Notes Sign Up](https://share.hsforms.com/1iZCRfUF5QHeWYwcLC3bwEAdk6gc) Open main navigation Close main navigation - [Release Notes Sign Up](https://share.hsforms.com/1iZCRfUF5QHeWYwcLC3bwEAdk6gc) - English Show submenu for translations - [File a Support Ticket](https://support.atomicjolt.com/knowledgebase/kb-tickets/new) - [Customer Portal](https://support.atomicjolt.com/tickets-view) How can we help you? - There are no suggestions because the search field is empty. 1. [Atomic Jolt Knowledge Base](https://support.atomicjolt.com/knowledgebase?hsLang=en) 2. [Atomic Assessments](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en) 3. [Advanced Features](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#advanced-features) # Obtaining Atomic Assessments Score Data using Submission Webhooks ## Atomic Assessments offers a submission webhook for customers to retrieve student assessment submission score data. This is a premium feature requiring an additional license agreement. 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 details. Atomic Assessments provides the following two 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](https://support.atomicjolt.com/hubfs/payload.json?hsLang=en) - [Here's a JSON schema describing the structure](https://support.atomicjolt.com/hubfs/schema.json?hsLang=en) **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 can't deliver a payload because your endpoint is down or returns an error, it automatically retries the delivery five more times over about 31 hours: after 1 minute, 15 minutes, 1 hour, 6 hours, and 1 day. Scores that still fail after the last retry are not kept for later delivery. Changing the grade on an attempt also sends its score again. **Note:** A Scores API for checking and re-requesting score deliveries is not currently available. Scores are delivered through the webhook, which automatically retries failed deliveries for about 31 hours. If you believe scores are missing, contact support. **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](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](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 webhook. 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. - [Atomic Jolt Customer FAQs](https://support.atomicjolt.com/knowledgebase/atomic-jolt-customer-faqs?hsLang=en) - [Atomic Assessments](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#main-content) - [Release Notes](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#release-notes) - [Authoring Assessments](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#authoring-assessments) - [For Nursing](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#for-nursing) - [Content Management](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#content-management) - [Question Types](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#question-types) - [Grading & Feedback](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#grading-feedback) - [Reports](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#reports) - [Import and Export](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#import-and-export) - [Advanced Features](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#advanced-features) - [Proctoring](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#proctoring) - [Installation Guides](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#installation-guides) - [FAQ for Atomic Assessments](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#faq-for-atomic-assessments) - [Adaptive Assessments](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#adaptive-assessments) - [Learning Standards](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#learning-standards) - [Brightspace](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#brightspace) - [Canvas](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#canvas) - [Publishers](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#publishers) - [Admin Features](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#admin-features) - [Atomic Search](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#main-content) - [FAQs](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#faqs) - [Using Search](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#using-search) - [Admin Features](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#admin-features) - [Content Indexing](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#content-indexing) - [Reports & Analytics](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#reports-analytics) - [Brightspace Support](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#brightspace-support) - [Canvas Support](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#canvas-support) - [Atomic Journals](https://support.atomicjolt.com/knowledgebase/atomic-journals?hsLang=en#main-content) - [Course Authors](https://support.atomicjolt.com/knowledgebase/atomic-journals?hsLang=en#course-authors) - [Student Experience](https://support.atomicjolt.com/knowledgebase/atomic-journals?hsLang=en#student-experience) - [Atomic Polls](https://support.atomicjolt.com/knowledgebase/atomic-polls?hsLang=en#main-content) - [Course Authors](https://support.atomicjolt.com/knowledgebase/atomic-polls?hsLang=en#course-authors) - [Student Experience](https://support.atomicjolt.com/knowledgebase/atomic-polls?hsLang=en#student-experience) - [Course Copy](https://support.atomicjolt.com/knowledgebase/atomic-polls?hsLang=en#course-copy) - [Atomic Discussions](https://support.atomicjolt.com/knowledgebase/atomic-discussions?hsLang=en#main-content) - [Course Authors](https://support.atomicjolt.com/knowledgebase/atomic-discussions?hsLang=en#course-authors) - [Student Experience](https://support.atomicjolt.com/knowledgebase/atomic-discussions?hsLang=en#student-experience) - [Atomic Author](https://support.atomicjolt.com/knowledgebase/atomic-author?hsLang=en) - [Atomic Socialize](https://support.atomicjolt.com/knowledgebase/atomic-socialize?hsLang=en#main-content) - [Release Notes](https://support.atomicjolt.com/knowledgebase/atomic-socialize?hsLang=en#release-notes) - [Atomic Curriculum Analysis Tool](https://support.atomicjolt.com/knowledgebase/atomic-curriculum-analysis-tool?hsLang=en) [![Atomic Jolt Logo Horiz Small](https://support.atomicjolt.com/hs-fs/hubfs/Atomic%20Jolt%20Logo%20Horiz%20Small.png?width=164&height=60&name=Atomic%20Jolt%20Logo%20Horiz%20Small.png "Atomic Jolt Logo Horiz Small")](https://www.atomicjolt.com) Copyright © 2025, Atomic Jolt