Scoring Service REST API Overview

This document is for people using the REST API released in December of 2020. If you're using our legacy Scoring Service see the Scoring Service XML-RPC API Overview.

The process of scoring student assessments and reporting results has evolved greatly over the years. From teachers sitting with paper-based answer sheets to bubble-sheets fed through a machine that produces a percent correct, technology has helped to enhance the process of scoring tests. While percent correct on an assessment can be valuable, many assessments benefit from reporting an estimate of the underlying student ability in an educational construct (i.e. reading, mathematics). These ability estimates provide indicators of status and can be used to monitor growth over time.

The MetaMetrics Scoring Service API has been designed to simplify the process of assigning an ability estimate to a test-taker. As students take assessments, test results can be sent to the Scoring Service API, providing real-time estimates of student ability. The API supports reporting:
  • standard measures (called ability in the API response) where there is no prior information about a student.
  • Bayesian measures (called ability in the API response) where prior information about a student combines with the current assessment to yield a more-precise estimate.

The standard measures received from the API should be saved because they can be used as prior student information when making Bayesian calls.

Here you'll find the steps necessary for a partner to integrate the MetaMetrics’ Scoring Service API into their product. This includes information on the types of measures supported by the API, the information required to use the API, and reporting guidelines.