getQualificationRequests - Amazon Mechanical Turk
DescriptionArgumentsExampleOutputRelated Commands

This software is not currently supported by Amazon Mechanical Turk

The Amazon Mechanical Turk Command Line Tools (CLT) are not currently maintained by Amazon Mechanical Turk. If you would still like to use Amazon Mechanical Turk from the command line, use the mturk command in the AWS Command Line Interface (CLI). For more information, see the mturk section of the AWS CLI Command Reference .

 

getQualificationRequests

Description

The getQualificationRequests command retrieves the Qualification requests from Workers for your Qualifications. For more information about Qualifications and Qualification requests see the Amazon Mechanical Turk Developer Guide.

Arguments

The following table describes the arguments for the getQualificationRequests command.

Name Description Required

-help or -h

Displays the help for this operation.

Example: -help

No

-outputfile [filename]

Specifies the output file. This is a tab delimited text file that contains the details of Workers' Qualification. You can then approve or reject the Qualification Requests by using approveQualificationRequests or rejectQualificationRequests command. For information about this file, see The Qualification request file in Files Used by the Command Line Tools.

Example: -outputfile qualification_requests.txt

Yes

-qualtypeid [Qualification Type ID]

Specifies the Qualification Type ID of the Qualification you want to retrieve requests for. This ID is in a .success file generated after you create the Qualification with the createQualificationType command. If this ID is not specified, all Qualification requests for Qualifications you own are included in the output file.

Example:-qualtypeid RWFZTKZ55ZPZXN1C8TDZ

No

-sandbox

Runs this command in the Amazon Mechanical Turk sandbox for testing. This argument takes precedence even if you specify the production web site in your mturk.properties file.

Example:-sandbox

No

Example

The following examples for Unix and Windows show how to use the getQualificationRequests command. These examples write the requests for all Qualification types to the file qualrequests.txt.

Unix

The following example demonstrates how to call this command from Unix: 


./getQualificationRequests.sh -outputfile qualrequests.txt

Windows

The following example demonstrates how to call this command from Microsoft Windows: 


getQualificationRequests -outputfile qualrequests.txt

Output

These examples retrieved four Qualfication requests and produced the following output.


Retrieved 4 Qualification Requests
Answers successfully saved to file: qualrequests.txt

Related Commands