ListHITs
Description
The ListHITs
operation returns all of a Requester's HITs. The operation returns HITs of any status, except for HITs that have been deleted of with the DeleteHIT
operation or that have been auto-deleted.
Having high volumes of active HITs may lead to latency or timeouts when calling ListHITs
. To remedy this, call the DeleteHIT operation on HITs you no longer need access to.
Request Syntax
{ "NextToken":
String
, "MaxResults":Integer
}
Request Parameters
The request accepts the following data in JSON format:
Name | Description | Required |
---|---|---|
|
Pagination token Type: String |
No |
|
Type: Integer |
No |
Response Elements
A successful request returns a paginated list of HIT data structures.
Example
The following example shows how to use the ListHITs
operation:
Sample Request
POST / HTTP/1.1 Host: mturk-requester.us-east-1.amazonaws.com Content-Length: <PayloadSizeBytes> X-Amz-Date: <Date> { }
Sample Response
The following is an example response:
HTTP/1.1 200 OK x-amzn-RequestId: <RequestId> Content-Type: application/x-amz-json-1.1 Content-Length: <PayloadSizeBytes> Date: <Date> { NextToken:
PaginationToken
, NumResults:10, HITs:[HIT] }