Back to Knowledge Base
API, SDK & CLI Guides

Get the status of a set of tasks

get
https://api.sama.com/v2/projects//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
int64
required

ID of the project

Query Params
int64

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

string

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

string
enum

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

Allowed:
string

Comma-separated list of primary keys.

string
enum

Date type

Allowed:
date-time

RFC3339 timestamp that you want to query up to

date-time

RFC3339 timestamp that you want to query from

string
enum

State of the task

Allowed:
int64
-2147483648 to 2147483647

Priority assigned to task

boolean

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

boolean

when true, omits answers from the response

int64
1 to 100
Defaults to 100

Number of results per page

int64
≥ 1
Defaults to 1

Page number

Response

Updated 7 months ago

Language
Credentials
Query
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 7 months ago