Get the status of a set of tasks

get https://api.sama.com/v2/projects/{projectId}/tasks.json

The statuses of a set of tasks can also be retrieved by entering a combination of filters as parameters in the url. Answers returned will be the latest answers, unless the task is Rejected, in which case the default answers will be returned. Results will automatically be paginated to 100 tasks.

There is a rate limit of 1 call/second for this endpoint. If the limit is reached, a 429 error code is returned.

An optional page_size and page parameter can be used to set a page size (max. 100) and number respectively.

Path Params

projectId

int64

required

ID of the project

Query Params

batch_id

int64

Identifier assigned to task batches uploaded by project managers, or created via API

client_batch_id

string

Any input can be set up to be used as a client defined batch identifier

client_batch_id_match_type

string

Search strategy for the client batch id. The default strategy is exact.

primary_keys

string

Comma-separated list of primary keys.

date_type

string

Date type

date-time

RFC3339 timestamp that you want to query up to

from

date-time

RFC3339 timestamp that you want to query from

state

string

State of the task

priority

int64

-2147483648 to 2147483647

Priority assigned to task

same_as_delivery

boolean

It should be set to "true" if the delivery schema should be used for the response.

omit_answers

boolean

when true, omits answers from the response

page_size

int64

1 to 100

Defaults to 100

Number of results per page

page

int64

≥ 1

Defaults to 1

Page number

Response

Language

Credentials

Query


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.sama.com/v2/projects/projectId/tasks.json?page_size=100&page=1' \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The response will contain the original data for the task as well as the most recent answers supplied by a worker.