View a markdown version of this page

QualificationRequest - Amazon Mechanical Turk
DescriptionElementsExample

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.

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"
}