Method: listAssignmentAttempts

The method will help to get grades for each attempt to respond to the assignment.

Permissions to Run the Request

Account Owner, Account Administrators, Department Administrators or custom roles that allow to grade assignments.

Request Parameters

Parameter	Type	Description
token (required)	string	Access token. You can obtain a token by making a request.
assignmentId (required)	string	The assignment ID.
userIds (optional)	array	The IDs of users whose attempts you want to retrieve.

Return Values

Parameter	Type	Description
attempts	AssignmentAttempt[]	An array with attempts.

AssignmentAttempt

Parameter	Type	Description
attemptId	string	The attempt ID.
enrollmentId	string	The enrollment ID.
userId	string	The user ID who made the attempt
comment	string	Comment.
attachments (optional)	AssignmentAttemptAttachment[]	Attachments for the attempt.

AssignmentAttemptAttachment

Parameter	Type	Description
fileName	string	The name of the file.
fileSize	integer	File size in bytes.
url	string	Url to download file.

Possible Errors

Error	Description
InvalidArgumentException	Invalid request.
Permission denied	The user doesn't have permission to handle the request.

Sample Request

SoapAction: "https://%HOST%/soap/2.0/listAssignmentAttempts"

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://ispringlearn.com/go/services/api/soap">
    <soapenv:Header/>
    <soapenv:Body>
        <soap:ListAssignmentAttemptsRequest>
            <soap:credentials>
               <soap:token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</soap:token>
            </soap:credentials>
            <soap:assignmentId>f63d54e2-22ac-11ec-aca4-0242ac140038</soap:assignmentId>
            <soap:userIds>
                <soap:id>62927f9e-871e-11eb-b8cf-0242ac1a0028</soap:id>
            </soap:userIds>
        </soap:ListAssignmentAttemptsRequest>
    </soapenv:Body>
</soapenv:Envelope>

XML

Sample Response

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://ispringlearn.com/go/services/api/soap">
    <SOAP-ENV:Body>
        <ns1:ListAssignmentAttemptsResult>
            <ns1:attempts>
                <ns1:attempt>
                    <ns1:attemptId>2b70bd59-31a8-11ec-81f2-0242ac190004</ns1:attemptId>
                    <ns1:enrollmentId>840869b4-22ae-11ec-9665-0242ac140038</ns1:enrollmentId>
                    <ns1:userId>62927f9e-871e-11eb-b8cf-0242ac1a0028</ns1:userId>
                    <ns1:comment>100</ns1:comment>
                </ns1:attempt>
                <ns1:attempt>
                    <ns1:attemptId>2b70bdd9-31a8-11ec-81f2-0242ac190004</ns1:attemptId>
                    <ns1:enrollmentId>0e1ce016-22b0-11ec-a4c6-0242ac140038</ns1:enrollmentId>
                    <ns1:userId>62927f9e-871e-11eb-b8cf-0242ac1a0028</ns1:userId>
                    <ns1:comment>Attempt 2</ns1:comment>
                    <ns1:attachments>
                        <ns1:attachment>
                            <ns1:fileName>test.xlsx</ns1:fileName>
                            <ns1:fileSize>4737</ns1:fileSize>
                            <ns1:url>
                                https://myaccount.ispringlearn.com/proxy/learn-cnode/attachment/1-TCtyF-Fj8EX-zi1MH/1/14.xlsx/test.xlsx?pk=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdSI6InZpYXRjaGVzbGF2LXRhcmFzb3YtMSIsInV1IjoiZmQyNmMzMTQtODMxMS0xMWViLTk3OTgtMDI0MmFjMTMwMDI4IiwiY2siOiIxLVRDdHlGLUZqOEVYLXppMU1IIiwiYW0iOjIsImV0IjoxNjM1OTQzODYyfQ.Fy-bbQFjRUnc5vZ-Vib5CkVA2OnDy9NPD_GNSiVCGZc
                            </ns1:url>
                        </ns1:attachment>
                    </ns1:attachments>
                </ns1:attempt>
            </ns1:attempts>
        </ns1:ListAssignmentAttemptsResult>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

XML