Chart Generation – Summative Data
POST /student-growth-summative: Generate a growth chart based on student summative assessment data.
Summative: This endpoint exclusively accepts summative Lexile and Quantile measures derived from end-of-grade or end-of-course state assessments. For each measure submitted, the following information must be included: the date the measure was obtained, the student’s grade at the time, and the school year start date for that grade. The Growth Planner API utilizes this data to project the student’s growth in reading and math by the end of grade 12 in relation to college and career-ready targets.
Base URL: https://growth-planner-api.lexile.com/student-growth-summative
Given historical student performance (measurements, dates) on summative assessments, this API will generate a graph of their projected growth. No PII is required by the API, and no data is saved. Graphs can be generated using either Lexile or Quantile student measures.
The graph plots the student's measures and makes a prediction for growth through 12th grade. Visual indicators on the graph show the recommended growth path, as well as various College and Career Readiness Ranges. The graph is WCAG 2.1 AA compliant, and all information required for the generation of informative alt-text is in the response data. Clients should use this data to write their own alt-text.
Parameters
POST /authToken Retrieve an Auth Token for use with protected endpoints.
application/json
{
"scale": "lexile",
"language": "english",
"measures": [
{
"testDate": {
"month": 3,
"year": 2021
},
"schoolYearStart": {
"month": 8,
"year": 2020
},
"grade": 4,
"measure": 815
},
{
"testDate": {
"month": 3,
"year": 2022
},
"schoolYearStart": {
"month": 8,
"year": 2021
},
"grade": 5,
"measure": 930
},
{
"testDate": {
"month": 3,
"year": 2023
},
"schoolYearStart": {
"month": 8,
"year": 2022
},
"grade": 6,
"measure": 1040
},
{
"testDate": {
"month": 3,
"year": 2024
},
"schoolYearStart": {
"month": 8,
"year": 2023
},
"grade": 7,
"measure": 1170
}
],
"additionalOptions": [
"recommendedGrowthPath",
"universityReadinessRange",
"communityCollegeReadinessRange",
"workplaceReadinessRange"
]
}
{
"scale": "quantile",
"language": "english",
"measures": [
{
"testDate": {
"month": 3,
"year": 2021
},
"schoolYearStart": {
"month": 8,
"year": 2020
},
"grade": 4,
"measure": 815
},
{
"testDate": {
"month": 3,
"year": 2022
},
"schoolYearStart": {
"month": 8,
"year": 2021
},
"grade": 5,
"measure": 930
},
{
"testDate": {
"month": 3,
"year": 2023
},
"schoolYearStart": {
"month": 8,
"year": 2022
},
"grade": 6,
"measure": 1040
},
{
"testDate": {
"month": 3,
"year": 2024
},
"schoolYearStart": {
"month": 8,
"year": 2023
},
"grade": 7,
"measure": 1170
}
],
"additionalOptions": [
"recommendedGrowthPath",
"advancedCollegeAndCareerReadinessRange",
"fundamentalCollegeAndCareerReadinessRange",
"limitedCollegeAndCareerReadinessRange"
]
}
Responses
Responses
Code | Description |
---|---|
200 |
Success Media Type: application/json Example Value / Schema
|
400 |
Validation error response Media Type: application/json Example Value / Schema
|
401 |
Client error response Media Type: application/json Example Value / Schema
|
500 |
Server error response Media Type: application/json Example Value / Schema
|