The Assignment data structure represents a single assignment of a HIT to a Worker. The assignment tracks the Worker's efforts to complete the HIT, and contains the results for later retrieval.
Assignment is a JSON Structure definition published by Amazon Mechanical Turk, describing 12 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/amazon-mechanical-turk/refs/heads/main/json-structure/amazon-mechanical-turk-assignment-structure.json",
"name": "Assignment",
"description": " The Assignment data structure represents a single assignment of a HIT to a Worker. The assignment tracks the Worker's efforts to complete the HIT, and contains the results for later retrieval. ",
"type": "object",
"properties": {
"AssignmentId": {
"allOf": [
{
"$ref": "#/components/schemas/EntityId"
},
{
"description": " A unique identifier for the assignment."
}
]
},
"WorkerId": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId"
},
{
"description": " The ID of the Worker who accepted the HIT."
}
]
},
"HITId": {
"allOf": [
{
"$ref": "#/components/schemas/EntityId"
},
{
"description": " The ID of the HIT."
}
]
},
"AssignmentStatus": {
"allOf": [
{
"$ref": "#/components/schemas/AssignmentStatus"
},
{
"description": " The status of the assignment."
}
]
},
"AutoApprovalTime": {
"allOf": [
{
"$ref": "#/components/schemas/Timestamp"
},
{
"description": " If results have been submitted, AutoApprovalTime is the date and time the results of the assignment results are considered Approved automatically if they have not already been explicitly approved or rejected by the Requester. This value is derived from the auto-approval delay specified by the Requester in the HIT. This value is omitted from the assignment if the Worker has not yet submitted results."
}
]
},
"AcceptTime": {
"allOf": [
{
"$ref": "#/components/schemas/Timestamp"
},
{
"description": " The date and time the Worker accepted the assignment."
}
]
},
"SubmitTime": {
"allOf": [
{
"$ref": "#/components/schemas/Timestamp"
},
{
"description": " If the Worker has submitted results, SubmitTime is the date and time the assignment was submitted. This value is omitted from the assignment if the Worker has not yet submitted results."
}
]
},
"ApprovalTime": {
"allOf": [
{
"$ref": "#/components/schemas/Timestamp"
},
{
"description": " If the Worker has submitted results and the Requester has approved the results, ApprovalTime is the date and time the Requester approved the results. This value is omitted from the assignment if the Requester has not yet approved the results."
}
]
},
"RejectionTime": {
"allOf": [
{
"$ref": "#/components/schemas/Timestamp"
},
{
"description": " If the Worker has submitted results and the Requester has rejected the results, RejectionTime is the date and time the Requester rejected the results."
}
]
},
"Deadline": {
"allOf": [
{
"$ref": "#/components/schemas/Timestamp"
},
{
"description": " The date and time of the deadline for the assignment. This value is derived from the deadline specification for the HIT and the date and time the Worker accepted the HIT."
}
]
},
"Answer": {
"allOf": [
{
"$ref": "#/components/schemas/String"
},
{
"description": " The Worker's answers submitted for the HIT contained in a QuestionFormAnswers document, if the Worker provides an answer. If the Worker does not provide any answers, Answer may contain a QuestionFormAnswers document, or Answer may be empty."
}
]
},
"RequesterFeedback": {
"allOf": [
{
"$ref": "#/components/schemas/String"
},
{
"description": " The feedback string included with the call to the ApproveAssignment operation or the RejectAssignment operation, if the Requester approved or rejected the assignment and specified feedback."
}
]
}
}
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.