Get Results

The Assignment & Grades endpoint tools call to read grades. You never call this — LTIAAS relays it to your Service URL as a RESULTS_GET service request.

Requires an access token with the GRADES_READ scope.

Path Parameters

contextId string required
The URL-encoded context identifier — the same context value you supplied when starting the launch.
Example: 2022CSEa5e6c431b91
lineItemId string required
The line item identifier your Service URL assigned.
Example: 412

Query Parameters

user_id string

Only return the result for this user.

Responses

• 200
• 401
• 403

---

Results

application/json

Schema

Example (from schema)

---

Schema

• Array [
id string

Your identifier for the result. Combining the line item and user IDs is fine.

userId string
comment string
resultScore number
resultMaximum number
• ]

[
  {
    "id": "11",
    "userId": "41",
    "comment": "Great work!",
    "resultScore": 99,
    "resultMaximum": 100
  }
]

The Authorization header was missing, malformed, or carried the wrong key.

application/json

Schema

Example (from schema)

Example

---

Schema

status integer
error string
details object

Context for the failure. Always carries a message code; the other keys depend on what went wrong.

message string

description string

property name* any

Context for the failure. Always carries a message code; the other keys depend on what went wrong.

{
  "status": 403,
  "error": "Forbidden",
  "details": {
    "message": "INACTIVE_SERVICE",
    "description": "string"
  }
}

{
  "status": 401,
  "error": "Unauthorized",
  "details": {
    "message": "INVALID_BEARER_AUTHORIZATION_HEADER",
    "description": "Invalid API Key for account."
  }
}

The LTI® service this endpoint depends on is not enabled on your account.

application/json

Schema

Example (from schema)

Example

---

Schema

status integer
error string
details object

Context for the failure. Always carries a message code; the other keys depend on what went wrong.

message string

description string

property name* any

Context for the failure. Always carries a message code; the other keys depend on what went wrong.

{
  "status": 403,
  "error": "Forbidden",
  "details": {
    "message": "INACTIVE_SERVICE",
    "description": "string"
  }
}

{
  "status": 403,
  "error": "Forbidden",
  "details": {
    "message": "INACTIVE_SERVICE",
    "service": "Deep Linking"
  }
}

Loading...