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

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:

Name Description Required

QualificationTypeId

The ID of the QualificationType.

Type: String

No

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 }