> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/developer-tools-and-resources/api-reference/task-statuses-apis/returning-task-statuses.md).

# Returning Task Statuses

## Returns task statuses.

<mark style="color:blue;">`GET`</mark> `/tasks/{taskId}`

Returns task statuses by Id.

#### Path Parameters

| Name                                     | Type   | Description |
| ---------------------------------------- | ------ | ----------- |
| taskId<mark style="color:red;">\*</mark> | String | Task ID     |

{% tabs %}
{% tab title="200: OK Successful Operation" %}

```javascript
{
    content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskStatus'
}
```

{% endtab %}

{% tab title="401: Unauthorized Unauthorized" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="403: Forbidden Forbidden" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="500: Internal Server Error Internal Server Error" %}

```javascript
{
    content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
}
```

{% endtab %}
{% endtabs %}