Amazon Mechanical Turk will permanently close on September 30, 2026. For Workers and Requesters currently using the service, visit our Amazon Mechanical Turk help page to learn how you can prepare for this closure.

ListWorkerBlocks

Description

The ListWorkersBlocks operation retrieves a list of Workers who are blocked from working on your HITs.

Request Syntax

{ 
  "NextToken": String,

  "MaxResults": Integer
 }

Request Parameters

The request accepts the following data in JSON format:

Response Elements

A successful request returns a paginated list of Workers that have been blocked along with the reason for the block.

Example

The following example shows how to use the ListWorkerBlocks operation:

Sample Request

The following example lists all Worker blocks.

POST / HTTP/1.1
Host: mturk-requester.us-east-1.amazonaws.com
Content-Length: <PayloadSizeBytes>
X-Amz-Date: <Date>
{
}

Sample Response

The following is an example response:

HTTP/1.1 200 OK
x-amzn-RequestId: <RequestId>
Content-Type: application/x-amz-json-1.1
Content-Length: <PayloadSizeBytes>
Date: <Date>
{
  WorkerBlocks:[{WorkerId, Reason}],
  NumResults:3
}