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.
Anyone who knows the Qualification type ID and the user ID can query the value for a user's Qualification. (Only the author of the Qualification type can grant the Qualification or update the value.)
Using GetQualificationScore (REST)
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] &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:
| Name | Description | Type | Value |
|---|---|---|---|
| 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.
The Qualification element contains the following elements:
| Name | Description | Value |
|---|---|---|
| QualificationTypeId |
The ID of the Qualification type. |
A Qualification type ID |
| CreationTime |
The date and time the Qualification was first granted to the user. |
A dateTime in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z |
| Value |
The value (score) of the Qualification. |
An integer |