Get Measure Using Form ID
Overview
- There is no prior information about a student.
- The student has taken an entire test form, represented by a form ID.
- The raw score, or number of items answered correctly, is known.
URL
POST /api/score/form/id/standard
Request
The following parameters are required in the request. An example is provided in the Code Example section.
Parameter | Type | Description |
---|---|---|
formId |
String |
The ID of the form. Must have a prefix of “Q”, “L”, "S" or “A” to indicate form type. MetaMetrics will provide this ID. |
numberCorrect |
Integer |
Raw count of items answered correctly by the student. |
Parameter | Type | Description |
---|---|---|
formId |
String |
The ID of the form. Must have a prefix of “Q”, “L”, or “S” to indicate form type. MetaMetrics will provide this ID. |
numberCorrect |
Integer |
Raw count of items answered correctly by the student. |
Response
This returns an object that contains the computed ability and uncertainty. See Scoring Service Response Codes for an explanation of codes that might be returned.
Parameter | Type | Description |
---|---|---|
ability |
Integer |
The student’s new ability estimate. |
uncertainty |
Integer |
Uncertainty associated with the student’s new ability estimate. |
framework |
String | Either Lexile or Quantile framework used to produce the measure. |
apiVersion |
String | The current version number for the API. |
Code Examples
The following show examples of the request followed by the response. The Python example is written for use with Python 3 and above.