Session Response Score Grading endpoint

Manages retrieval and update of manual grading scores linked to individual Item responses in a session.

Endpoints:

• Get Session Response Score Grading
• Update Session Response Score Grading

Usage

The format of requests to the Data API uses the following syntax:

https://data.learnosity.com/{LTS_VERSION}/{endpoint}

For example, to use the v2025.2.LTS version and the /sessions/responses/scores/grading endpoint, you would create a request like so:

https://data.learnosity.com/v2025.2.LTS/sessions/responses/scores/grading

Important The Data API is not a REST API. All requests must use the POST method, with the action request body parameter specifying the operation to use. The Learnosity SDK must be used to make requests to Data API.

Note The Data API usage is subject to rate limits.

Related articles:

• Getting Started with the Data API
• See Release Cadence and Version Lifecycle for more information on available LTS versions.

Retrieves the manual grading scores linked to individual Item responses in a session.

You would use this endpoint so that you can access manually assigned grading scores for individual Item responses when reviewing or reporting on a session.

Auto-scored grader entries are not included in the response.

Request body parameters

Body content type: application/json

• session_id string

  A session ID to retrieve.

Request body example

{
    "session_id": "30f62430-5dfa-48eb-bacd-c898d5bdf682"
}

Responses

Response example

{
    "meta": {
        "status": true,
        "timestamp": 1744349597
    },
    "data": [
        {
            "session_id": "30f62430-5dfa-48eb-bacd-c898d5bdf682",
            "items": [
                {
                    "item_reference": "f2175579-3544-47f5-bcdb-73f216798471",
                    "responses": [
                        {
                            "response_id": "30f62430-5dfa-48eb-bacd-c898d5bdf682_4747e121c5af5f53e3a517a76025e281",
                            "graders": [
                                {
                                    "grader_id": "grader1234",
                                    "score": 8,
                                    "max_score": 10,
                                    "is_reference": true,
                                    "source": "lrn_manual_grading",
                                    "time_created": "2026-07-06 00:50:03.395242+00",
                                    "time_updated": "2026-07-06 00:50:03.395242+00"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

Updates the manual grading scores for individual Item responses in a specific session.

Request body parameters

Body content type: application/json

• session_id string

  The ID of the session.

• items array[object]

  A list of Items responses to update.

  The following properties are supported.

  • item_reference string

    The Item ID.

  • responses array[object]

    A list of response object definitions for updating the session response scores.

    The following properties are supported.

    • response_id string

      The ID of the response.

    • scores array[object]

      A list of grader score entries to set for this response.

      The following properties are supported.

      • grader_id string

        The ID of the grader. Must not exceed 50 characters.

      • score number

        The score value. Must be 0 or greater.

      • max_score number

        The maximum possible score. Must be 0 or greater.

Request body example

{
    "session_id": "30f62430-5dfa-48eb-bacd-c898d5bdf682",
    "items": [
        {
            "item_reference": "f2175579-3544-47f5-bcdb-73f216798471",
            "responses": [
                {
                    "response_id": "30f62430-5dfa-48eb-bacd-c898d5bdf682_4747e121c5af5f53e3a517a76025e281",
                    "scores": [
                        {
                            "grader_id": "grader1234",
                            "score": 8,
                            "max_score": 10
                        }
                    ]
                }
            ]
        }
    ]
}

Responses

Response example

{
    "meta": {
        "status": true,
        "timestamp": 1744251497
    },
    "data": {
        "session_id": "30f62430-5dfa-48eb-bacd-c898d5bdf682",
        "updated_count": 1
    }
}