---
search:
  tags:
    - tasks
    - GET
seo:
  description: >-
    Returns every form instance on the task, including… Reference for the GET
    /tasks/{identifier}/form-instances endpoint in the Leadtime Public API API.
sidebar:
  badge: GET
  label: List form instances on a task
title: List form instances on a task
type: openapi-operation
---
Returns every form instance on the task, including `templateId`, current `values`, and a `fields` array for each instance. Each field includes `valueKey` — use that string as the property name in the `values` object when calling PATCH `/tasks/{identifier}/form-instances/{formInstanceId}`. To choose which template to attach next, list templates with GET `/workspace/form-templates` (template `id` is the `templateId` for POST). For the full static schema of a template (before attach), use GET `/workspace/form-templates/{id}`.

<Operation source="api-reference" id="taskforminstancescontroller-list" />