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

In 2017 Amazon Mechanical Turk (MTurk) launched support for the AWS Software Development Kits (SDKs). This gives more tool choices to MTurk Requester customers as you can now choose from nine new SDKs that are already widely used in the AWS community. The MTurk API can now be accessed using the following AWS SDKs: Python/Boto (Boto3), Javascript (NodeJS or Browser), Java.NET, Go, Ruby, PHP or C++. This also makes it easier for customers to connect MTurk with other AWS services like S3, Lambda, Step Functions, Lex, Polly, Rekognition, Amazon Machine Learning, AWS Batch, EC2, and many more.

As part of this launch, MTurk also released a new version of the Requester API (version: ‘2017–01–17’). This version significantly updates naming conventions used in the API and adopts the AWS standard of Signature Version 4 to authenticate requests securely. The API uses REST requests and no longer requires that developers be with the SOAP protocol. These changes make the MTurk API consistent with other AWS APIs, simplifying the on-boarding process for both new and existing AWS developers. You are browsing the API reference for this new release.

Customers using the previous version of our API ('2014-08-15') with Mechanical Turk SDKs will not be affected by this change and can continue to operate as before. You can find the all the documentation for that version of the API here.


This is the Amazon Mechanical Turk API Reference. This guide provides detailed information about Amazon Mechanical Turk operations, data structures, and parameters. The major sections of this guide are described in the following table.

Amazon Mechanical Turk is a web service that provides an on-demand, scalable, human workforce to complete jobs that humans can do better than computers, for example, recognizing objects in photos. For more information about this product go to the Amazon Mechanical Turk website.


Alphabetical list of all Amazon Mechanical Turk operations.

Data Structure Schema Locations

Links to Amazon Mechanical Turk data structure schemas.

Question and Answer Data

Description of question and answer data that Amazon Mechanical Turk passes between Requesters and Workers.

Data Structures

Alphabetical list of all Amazon Mechanical Turk data structures.

Review Policies

Description of Amazon Mechanical Turk Review Policies.

Managing Notifications

Description of how Amazon Mechanical Turk sends notification messages to your application.