QualificationRequest - Amazon Mechanical Turk
DescriptionElementsExample

QualificationRequest

Description

The QualificationRequest data structure represents a request a Worker has made for a Qualification.

The QualificationRequest data structure is used as a response element for the following operations:

  • ListQualificationRequests

Elements

The QualificationRequest structure can contain the elements described in the following table:

Name Description Required

QualificationRequestId

The ID of the Qualification request, a unique identifier generated when the request was submitted. Can be up to 255 bytes in length.

Type: String

Default: None

No

QualificationTypeId

The ID of the Qualification type the Worker is requesting, as returned by the CreateQualificationType operation. Can be up to 255 bytes in length.

Type: String

Default: None

No

SubjectId

The ID of the Worker requesting the Qualification. This ID corresponds to the WorkerId returned with assignment results when the Worker performs a HIT. Can be up to 255 bytes in length.

Type: String

Default: None

No

Test

The contents of the Qualification test that was presented to the Worker, if the type has a test and the Worker has submitted answers. This value is identical to the QuestionForm associated with the Qualification type at the time the Worker requests the Qualification.

Type: a QuestionForm data structure

Default: None

No

Answer

The Worker's answers for the Qualification type's test contained in a QuestionFormAnswers document, if the type has a test and the Worker has submitted answers. If the Worker does not provide any answers, Answer may be empty.

Type: a QuestionFormAnswers data structure

Default: None

No

SubmitTime

The date and time the Qualification request had a status of Submitted. This is either the time the Worker submitted answers for a Qualification test, or the time the Worker requested the Qualification if the Qualification type does not have a test.

Type: a dateTime structure in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z

Default: None

No

Example

The following example shows a QualificationRequest data structure returned by the ListQualificationRequests operation. This operation returns the requests for Qualifications of a Qualification type to the owner of the type. 


QualificationRequest:{
  QualificationRequestId:"789RVWYBAZW00EXAMPLE951RVWYBAZW00EXAMPLE",
  QualificationTypeId:"789RVWYBAZW00EXAMPLE",
  SubjectId:"AZ3456EXAMPLE",
  Test:{
  	QuestionForm:[XML-encoded Question data]
	},
	Answer:{
		QuestionFormAnswers:[XML-encoded Answer data]
	},
  SubmitTime:"2005-12-01T23:59:59Z"
}