Get Scores from Line Item
The LTI protocol allows you to retrieves scores from the LMS grade book through the Assignment and Grades - Results service. LTIAAS gives you access to this service through the
/api/lineitems/:lineItemID/scores API endpoint.
|API Authentication Method||Supported|
The URL encoded line item ID.
Used to to filter the results to a single user. The results MUST contain at most 1 result. An empty array MAY be returned if the user does not have any result recorded.
Used to to restrict the number of results returned; the platform MAY further reduce the number of results returned at its own discretion.
Retrieves scores from a specific URL
- Array [
scores object required
The platform must return a result record for each user that has a non empty 'resultScore' for the queried upon line item. The platform MAY skip empty results.
URL uniquely identifying the result record.
The userId contains the LTI user ID identifying the recipient of the Result (usually a learner). The userId MUST be present.
URL identifying the Line Item to which this result belongs. Must be the same as the line item id and the value of the lineitem claim when included in the LTI message.
The timestamp MUST be present and indicate when the score was changed; it is intended to be used by the platform as a way to guard against out of order score updates. Score timestamp represents the server time when the Score state was modified.
The current score for this user. The value must be a numeric value. If no value exists, this attribute may be omitted, or have an explicit null value.
The 'resultMaximum' value MUST be a positive number (with 0 considered a negative number); if no value is specified, then a default maximum value of 1 must be used.
The current value for the comment. The value must be a string. If no value exists, this attribute may be omitted, blank or have an explicit null value.
A URL pointing to the next page of line items.
A URL pointing to the previous page of line items.
A URL pointing to the first page of line items.
A URL pointing to the last page of line items.
Unauthorized. Please check our guide on Authenticating API requests to learn about how authentication works in the LTIAAS API.
details object required
"description": "Invalid or expired ltik."