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.

GetQualificationScore

Description

The GetQualificationScore operation returns the value of a Worker's Qualification for a given Qualification type.

To get a Worker's Qualification, you must know the Worker's ID.

Only the owner of a Qualification type can query the value of a Worker's Qualification of that type.

Request Syntax

{ 
  "QualificationTypeId": String,

  "WorkerId": String
 }

Request Parameters

The request accepts the following data in JSON format:

Response Elements

A successful request returns a Qualification data structure.

Example

The following example shows how to use the GetQualificationScore operation:

Sample Request

The following example disposes a Qualification type and any HIT types that are associated with the Qualification type.

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

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>
{
  QualificationTypeId:"789RVWYBAZW00EXAMPLE951RVWYBAZW00EXAMPLE",
  WorkerId:"AZ3456EXAMPLE",
  IntegerValue:"95",
  GrantTime:"<date>"
}