GetQualificationScore

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

To get a user's Qualification, you must know the user's ID. A Worker's user ID is included in the assignment data returned by the GetAssignmentsForHIT operation.

Only the author (creator) of a Qualification type can query the value of a user's Qualification of that type.

The following example of a call to the GetQualificationScore operation gets the value of a Qualification for a given user and Qualification type.

http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2006-08-23
&Operation=GetQualificationScore
&Signature=[signature for this request]
&Timestamp=[your system's local time]
&QualificationTypeId=789RVWYBAZW00EXAMPLE
&SubjectId=AZ3456EXAMPLE

A request to the Mechanical Turk Service includes parameters that control its behavior and the data it returns. Required parameters must be included for the request to succeed.

GetQualificationScore accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.

The following parameters are specific to the GetQualificationScore operation:

NameDescriptionTypeValue
Operation

The operation you would like to call. To access the GetQualificationScore operation, set the Operation parameter to GetQualificationScore.

Required

GetQualificationScore

QualificationTypeId

The ID of the Qualification type, as returned by the CreateQualificationType operation.

Required

A Qualification type ID

SubjectId

The ID of the user whose Qualification is being updated.

A Worker's user ID is returned with assignment data by the GetAssignmentsForHIT operation.

Required

A user ID

A successful request for the GetQualificationScore operation will have a Qualification element in the response.

For information about the contents of the Qualification element, see the Qualification data structure.