Amazon Mechanical Turk
API Reference (API Version 2017-01-17)

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