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.

ListQualificationRequests

Description

The ListQualificationRequests operation retrieves requests for Qualifications of a particular Qualification type. The owner of the Qualification type calls this operation to poll for pending requests, and accepts them using the AcceptQualification operation.

Request Syntax

{ 
  "QualificationTypeId": String
 }

Request Parameters

The request accepts the following data in JSON format:

Response Elements

A successful request returns a paginated list of QualificationRequests.

Example

The following example shows how to use the ListQualificationRequests operation:

Sample Request

The following example lists requests for a Qualification type.

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

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