About Growth Planner API

This documentation is designed for developers, system integrators, product managers, and researchers who need to understand, implement, or evaluate the capabilities of this API.

The Growth Planner API provides authorized partners with secure, real-time access to predictive student growth data across the full K–12 continuum. Using a student’s reading and/or math ability, reported as Lexile and Quantile measures from either interim or summative assessments, it projects and monitors progress toward key milestones. Growth trajectories can begin as early as kindergarten when based on interim measures and extend through grade 12, while summative-based projections are available for grades 3–12.

The Growth Planner API supports three key tasks:

  • Plots a student’s current measure along with any available historical assessment data.
  • Projects the student’s likely growth across grade ranges.
  • Compares projected growth against selected targets to monitor progress.

To plot measurements, the API requires the student's grade level, Lexile and/or Quantile measure, the month the test was administered, and an estimate to describe the part of the school year during which the test was administered. The measurements are then plotted at the appropriate place within the grade.

The API adheres to REST principles, returns JSON-formatted responses, and is secured using OAuth 2.0.

The API has two main endpoints:

Summative Endpoint

This endpoint accepts summative Lexile and Quantile measures derived from end-of-grade or end-of-course state assessments. For each submitted measure, the following information is required: the date the measure was obtained, the student’s grade at the time of testing, and the school year start date for that grade. The Growth Planner API uses this data to project a student’s growth in reading and math through grade 12 in relation to College and Career Readiness targets. Results are returned as data output, with an optional MetaMetrics graph that can be configured to meet partner requirements.

MetaMetrics' Optional Graph Generation - Summative Data

MetaMetrics graphs can be generated using Lexile and Quantile student measures and include standard visual indicators and College and Career Readiness target ranges. Options are available to customize or adjust these elements based on partner requirements, with certain indicators appearing when defined conditions are met.

Interim Endpoint

This endpoint accepts interim Lexile and/or Quantile measures derived from approved assessment sources. For each submitted measure, the following information is required: the date the measure was obtained, the student’s grade at the time of testing, and the school year start date for that grade. The Growth Planner API uses this data to project a student’s growth in reading and/or math across configurable grade ranges, which may begin as early as kindergarten and extend through grade 12, in relation to defined readiness targets. Results are returned as data output, with an optional MetaMetrics graph that can be configured to meet partner requirements.

MetaMetrics' Optional Graph Generation - Interim Data

MetaMetrics graphs can be generated using Lexile and/or Quantile student measures and include standard visual indicators and College and Career Readiness target ranges. Options are available to customize or adjust these elements based on partner requirements, including modifying visual indicators and substituting alternative target ranges, with certain indicators appearing when defined conditions are met.

Note: For a complete, interactive view of the API, visit our Swagger documentation.

Custom client graphs require MetaMetrics’ review and approval and may be subject to certain restrictions. Please contact your sales representative to explore this option.