Percentile and groupings API

 

GET /norms/v2/percentile-bands

This endpoint returns the percentile bands for the API consumer

 

NWEA_INTERNAL users will have the option to use an ?api-key=<api_key> query parameter in order to view percentile bands for the specified (IC) API key. When not provided the API key of the API consumer will be used to load the appropriate percentile bands record.

All endpoint requests referenced below, which are required in the header:

  • Content-Type (This would be 'application/json') 
  • Authorization (The OAuth2 bearer access token obtained from /auth/v1/token)

Example cURL command and response:

  • curl --location --request GET 'https://api.nwea.org/norms/v2/percentile-bands' \

--header 'Authorization: Bearer 8JKOV16pUn3vZaAdal00gk0PLSZt'

 

Sample Response:

 

{
  "percentileBands": [
    {
      "season": "fall",
      "grade": "K",
      "subjectArea": "Algebra 1",
      "ranges": [
        {
          "percentileLow": 1,
          "percentileHigh": 40,
          "scoreLow": 100,
          "scoreHigh": 227
        },
        {
          "percentileLow": 43,
          "percentileHigh": 84,
          "scoreLow": 228,
          "scoreHigh": 247
        },
        {
          "percentileLow": 86,
          "percentileHigh": 99,
          "scoreLow": 248,
          "scoreHigh": 350
        }
      ]
    }
  ],
  "modifiedDateTime": "2021-05-25T12:00:00.000Z"
}

Some common response status code 

 
Status Code Description Action Required
200 OK The request has succeeded.  NA
401 Unauthorized The request authentication token expired or not valid  Check url /auth/v1/token
403 Forbidden
User is not authorized to access this resource with an explicit deny
 Check ICP app access
500 Internal Server Error The server encountered an unexpected condition that prevented it from fulfilling the request.