# Matillion REST API: Can I get a full list of all possible task states returnable via API?

**URL:** <https://matillioncommunity.discourse.group/t/matillion-rest-api-can-i-get-a-full-list-of-all-possible-task-states-returnable-via-api/1678>\
**Category:** Matillion ETL\
**Created:** [March 3, 2022, 12:46pm UTC](https://matillioncommunity.discourse.group/t/matillion-rest-api-can-i-get-a-full-list-of-all-possible-task-states-returnable-via-api/1678 "2022-03-03T12:46:52Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![grlef.zum.felde](https://avatars.discourse-cdn.com/v4/letter/g/ed655f/32.png) [@grlef.zum.felde](https://matillioncommunity.discourse.group/u/grlef.zum.felde)\
**Post date:** [March 3, 2022, 12:46pm UTC](https://matillioncommunity.discourse.group/t/matillion-rest-api-can-i-get-a-full-list-of-all-possible-task-states-returnable-via-api/1678/1 "2022-03-03T12:46:52Z")

</div>

I am monitoring the execution of a Matillion Task via API from a Python script.

&nbsp;

Once the task is done I want to continue toing other things in Python, but only if it finished successfully.

&nbsp;

API Call:

http://\<InstanceAddress\>/rest/v1/group/name/\<groupName\>/project/name/\<projectName\>/task/id/\<taskId\>

&nbsp;

Example return:

{

"id": 12345,

"type": "RUN\_ORCHESTRATION",

.....

"environmentName": "test",

**"state": "SUCCESS",**

"enqueuedTime": 1594729190954,

"startTime": 1594729190955,

"endTime": 1594729201024,

.....

Here "SUCCESS" is displayed, but what are other options?

I know of "QUEUED" and "RUNNING" so far.

&nbsp;

The general Docu is not sufficient in this case:

[https://documentation.matillion.com/docs/2972278](https://documentation.matillion.com/docs/2972278)

---

<div class="post-metadata">

**Author:** ![SubashSambath](https://avatars.discourse-cdn.com/v4/letter/s/a8b319/32.png) [@SubashSambath](https://matillioncommunity.discourse.group/u/SubashSambath)\
**Post date:** [March 3, 2022, 4:36pm UTC](https://matillioncommunity.discourse.group/t/matillion-rest-api-can-i-get-a-full-list-of-all-possible-task-states-returnable-via-api/1678/2 "2022-03-03T16:36:34Z")

</div>

Hai There are three state SUCCESS,FAILED,CANCELLED

---

<div class="post-metadata">

**Author:** ![SubashSambath](https://avatars.discourse-cdn.com/v4/letter/s/a8b319/32.png) [@SubashSambath](https://matillioncommunity.discourse.group/u/SubashSambath)\
**Post date:** [March 3, 2022, 4:39pm UTC](https://matillioncommunity.discourse.group/t/matillion-rest-api-can-i-get-a-full-list-of-all-possible-task-states-returnable-via-api/1678/3 "2022-03-03T16:39:16Z")

</div>

We also monitoring Task history through API Query component . Implemented Incremental load as well as .

Thank you

---

<div class="post-metadata">

**Author:** ![Pete](https://avatars.discourse-cdn.com/v4/letter/p/3ab097/32.png) [@Pete](https://matillioncommunity.discourse.group/u/Pete)\
**Post date:** [March 11, 2022, 10:40am UTC](https://matillioncommunity.discourse.group/t/matillion-rest-api-can-i-get-a-full-list-of-all-possible-task-states-returnable-via-api/1678/4 "2022-03-11T10:40:22Z")

</div>

We too found the docs not sufficient for the v1 API. We did, however, find the following task status from an example within the old v0 API - these do seem to be the same for V1.

- SUCCESS
- QUEUED
- RUNNING
- FAILED

(Found in Example 3 on this page: https://documentation.matillion.com/docs/2565073 )

&nbsp;