Lexile Framework for Oral Reading API Overview

The Lexile Framework for Oral Reading is a scientific approach to measuring both students’ oral reading ability and the oral readability of materials on the same Lexile developmental scale. The use of a single scale for both student ability and oral readability provides educators with easy testing, accurate reporting, and reliable monitoring of growth. To do this, the Lexile Framework for Oral Reading evaluates the oral readability of texts and students' reading performances to calculate the Lexile oral readability and reading measures and to provide additional information about oral reading performances.

The calls in this API can be used to calculate both the Lexile oral reading measure for a student and the Lexile oral readability measure of a passage or piece of text.

To use the API to calculate the Lexile oral readability measure for a passage or piece of text, simply submit a text file.

To get a Lexile oral reading measure for a student you can use reader/performance/ability by either:
  • Sending audio recordings of students’ read-aloud performances with an accompanying text file.
  • Sending student performance characteristics from one or more performances and an Oral Reading Difficulty measure for the text associated with each performance.
This will calculate and return a Lexile oral reading measure for the student. When you send audio and a text file, the call will also calculate performance characteristics that can include words correct per minute (WCPM) and accuracy. The audio file must be a .wav or .mp3 file with an audible sample that is long enough to be measured.

When you send multiple performances, it calculates the Lexile oral reading measure for each performance, it does not produce an aggregate measure.

You can use reader/performance/ability/aggregate to get an aggregate Lexile oral reading measure for multiple student performances during a single testing event. To do this you can either:
  • Send a list of performanceIDs that you received when submitting individual student performances with the reader/performance/ability call.
  • Send characteristics of students’ read-aloud performances (words correct per minute and accuracy) with an accompanying Lexile oral readability measure for each text.

This will calculate and return an aggregate Lexile oral reading measure for the group of performances.