> For the complete documentation index, see [llms.txt](https://docs.api.intratool.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.intratool.de/api-reference/tasks-2/task-progress-fields.md).

# TaskProgressFields

## Introduction

`TaskProgressFields` store values submitted according to [TaskField](/api-reference/tasks-2/task-fields.md) definitions while a user progresses or finishes a [TaskExecution](/api-reference/tasks-2/task-executions.md).

The `additional_information` field uses the shared [Rich Text](/introduction/rich-text.md) HTML format. The `value` and `request_value` fields use the same format when the related TaskField type stores rich text.

## Model Definition

**Alias**

`taskProgressField`

**Relations**

| Key             | Relation                                                   | Type       | Relation Field(s)   |
| --------------- | ---------------------------------------------------------- | ---------- | ------------------- |
| `taskExecution` | [TaskExecution](/api-reference/tasks-2/task-executions.md) | Belongs to | `task_execution_id` |
| `formField`     | [TaskField](/api-reference/tasks-2/task-fields.md)         | Belongs to | `form_field_id`     |

**Computed Properties**

* `resolved_value` - The field-type-specific normalized `value`, for example a [FilemanagerFile](/api-reference/filemanager/filemanager-files.md) for an uploaded file.

**Capabilities**

* [Translations](/introduction/resource-capabilities/translations.md) - `value`, `request_value`, and `additional_information` are translatable.

## Admin: List by TaskExecution

List progress fields for one execution, including soft-deleted records.

**Definition**

<mark style="color:green;">`GET`</mark> `/api/administration/tasks-2/executions/{taskExecution}/progress-fields`

**Route Parameters**

| Parameter       | Type      | Description       |
| --------------- | --------- | ----------------- |
| `taskExecution` | `integer` | TaskExecution ID. |

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/administration/tasks-2/executions/812/progress-fields', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
[
  {
    "id": 1401,
    "task_execution_id": 812,
    "form_field_id": 33,
    "lang_id": "en-US",
    "value": "All exits are clear.",
    "request_value": "All exits are clear.",
    "additional_information": null,
    "deleted_at": null
  },
  {
    "id": 1402,
    "task_execution_id": 812,
    "form_field_id": 34,
    "lang_id": "en-US",
    "value": "1",
    "request_value": true,
    "additional_information": "<p>Checked on site.</p>",
    "deleted_at": null
  }
]
```