v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1439144149.2 KB

The ListAssignmentsForHIT operation retrieves completed assignments for a HIT. You can use this operation to retrieve the results for a HIT.

You can get assignments for a HIT at any time, even if the HIT is not yet Reviewable. If a HIT requested multiple assignments, and has received some results but has not yet become Reviewable, you can still retrieve the partial results with this operation.

Use the AssignmentStatus parameter to control which set of assignments for a HIT are returned. The ListAssignmentsForHIT operation can return submitted assignments awaiting approval, or it can return assignments that have already been approved or rejected. You can set AssignmentStatus=Approved,Rejected to get assignments that have already been approved and rejected together in one result set.

Only the Requester who created the HIT can retrieve the assignments for that HIT.

Results are sorted and divided into numbered pages and the operation returns a single page of results. You can use the parameters of the operation to control sorting and pagination.

post/#X-Amz-Target=MTurkRequesterServiceV20170117.ListAssignmentsForHIT

Query parameters

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Headers

X-Amz-Target'MTurkRequesterServiceV20170117.ListAssignmentsForHIT' required

Request body

HITIdstring required

The ID of the HIT.

NextTokenstring

Pagination token

MaxResultsinteger
AssignmentStatusesAssignmentStatus[]

The status of the assignments to return: Submitted | Approved | Rejected

Response

Success

NextTokenstring

If the previous response was incomplete (because there is more data to retrieve), Amazon Mechanical Turk returns a pagination token in the response. You can use this pagination token to retrieve the next set of results.

NumResultsinteger

The number of assignments on the page in the filtered results list, equivalent to the number of assignments returned by this call.