ListWorkersWithQualificationType - Amazon Mechanical Turk
DescriptionRequest SyntaxRequest ParametersResponse ElementsExample

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]
}