View a markdown version of this page

ListWorkersWithQualificationType - Amazon Mechanical Turk
DescriptionRequest SyntaxRequest ParametersResponse ElementsExample

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.

ListWorkersWithQualificationType

Description

The ListWorkersWithQualificationType operation returns all of the Workers with a given Qualification type.

Request Syntax

{ 
  "QualificationTypeId": String,

  "Status": String,

  "NextToken": String,

  "MaxResults": Integer,
 }

Request Parameters

The request accepts the following data in JSON format:

Name Description Required

QualificationTypeId

The ID of the QualificationType.

Type: String

No

Status

The status of the Qualifications to return. Granted | Revoked

Type: String

No

NextToken

Pagination token

Type: String

No

MaxResults

Type: Integer

No

Response Elements

A successful request returns a paginated list of Qualifications that have been granted to Workers.

Example

The following example shows how to use the ListWorkersWithQualificationType operation:

Sample Request

The following example performs a simple text query for Qualification types.

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

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>
{
  NextToken:PaginationToken,
  NumResults:10,
  Qualifications:[Qualification]
}