Learnosity-PaperScorer API
Specialized API documentation for integrating PaperScorer's advanced printing and scanning capabilities into your Learnosity assessment platform. Works alongside the PaperScorer Core API.
Overview
The Learnosity-PaperScorer API enables seamless integration between PaperScorer's paper-based assessment capabilities and your Learnosity platform. Generate answer sheets directly from Learnosity Items or Activities, and sync scores back to Learnosity sessions for unified reporting.
Base URLs
https://api.paperscorer.comhttps://learnosity.paperscorer.comSupported Learnosity Item Types
PaperScorer can convert the following Learnosity item types to paper assessment sheets
Multiple Choice
Standard and block layout formats
Multiple Choice (Multiple Response)
Select all that apply questions
True or False
Binary response questions
Math (Fill in the Blanks)
Numeric response questions
Cloze Math
Mathematical fill-in questions
Match List
Matching questions
Order List
Sequencing questions
Sort List
Categorization questions
Gridded
Grid-based numeric responses
Essay (Rich Text)
Long-form written responses
Essay (Plain Text)
Plain text responses
Short Text
Brief written responses
More question types coming soon
Integration Workflow
Follow these steps to integrate PaperScorer with your Learnosity platform
Authentication
The integration process begins with API partner authentication using an oAuthToken, followed by educator login through the userLogin endpoint.
- If this is the first time that the educator has been logged into PaperScorer, we will create a new account.
- Session information is returned for subsequent API calls.
- Works alongside the PaperScorer Core API authentication.
Relevant Endpoints
/oauth/token/rest/googleApi/userLogin
Answer Sheet Generation
Educators create bubble sheets directly from Learnosity Item IDs or Activity IDs. The system generates answer sheets that map to your Learnosity assessments.
- A unique URL is returned by the endpoints to a PDF file, which can be printed and distributed to students.
- Each answer sheet receives a Form ID for later score retrieval.
- Supports multiple Learnosity item types including multiple choice, true/false, and more.
Relevant Endpoints
/api/getAnswerSheetPdfByItem/api/getAnswerSheetPdfForActivity/api/getQuestionSheetPdfByItemId/api/getQuestionSheetPdfForActivity
Scanning & Processing
Students complete their assessments on paper. Three submission methods are available for processing completed answer sheets.
- Mobile App: Scan sheets using the free PaperScorer iOS or Android app
- Email: Scan and email sheets directly to PaperScorer for processing
- Platform Upload: Upload scanned PDFs through your platform using the API
Relevant Endpoints
/rest/ps/submitAnswersheetProcessingJob/rest/ps/getProcessedFormIds
Score Retrieval
The getSessionIdsFromFormId endpoint returns Learnosity session IDs for processed sheets, enabling seamless score synchronization with your Learnosity platform.
- Scores are mapped back to Learnosity sessions for unified reporting.
- Use acknowledgeSyncScore to mark scores as synchronized.
- Supports both push (callback) and pull (polling) retrieval methods.
Relevant Endpoints
/rest/learnosity/getSessionIdsFromFormId/rest/ps/acknowledgeSyncScore
Secure Data Handling
All responses from the PaperScorer engine are encrypted with a key that is shared with our development partners for decryption. This ensures student data remains protected throughout the integration.
Decryption Libraries
Sample decryption libraries available in PHP and Java
Secure Authentication
OAuth 2.0 authentication for all API requests
// Example: Creating Sheet from Learnosity Activity
POST /rest/learnosity/createSheetFromActivity
{
"activityId": "act_123456",
"sessionId": "session_789",
"studentCount": 30,
"options": {
"includeStudentNames": true,
"bubbleStyle": "circle"
}
}
// Response
{
"success": true,
"formId": "form_abc123",
"pdfUrl": "https://api.paperscorer.com/..."
}Get Started for Free
You can create a free account with no obligation to purchase. Scan up to 100 testing sheets completely free while you test your Learnosity integration.