---
title: "List of form instances"
method: GET
path: "/form/form-instances"
tags: ["Form Instances"]
---

# List of form instances

`GET /form/form-instances`

## Request

- Base URL: `http://localhost:8090/form-api`
- URL: `http://localhost:8090/form-api/form/form-instances`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-form-rest-api/docs/form/form-instances/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `id` string
- `formDefinitionId` string
- `formDefinitionIdLike` string
- `taskId` string
- `taskIdLike` string
- `processInstanceId` string
- `processInstanceIdLike` string
- `processDefinitionId` string
- `processDefinitionIdLike` string
- `scopeId` string
- `scopeType` string
- `scopeDefinitionId` string
- `submittedBy` string
- `submittedByLike` string
- `tenantId` string
- `tenantIdLike` string
- `withoutTenantId` boolean
- `sort` 'submittedDate' | 'tenantId'

## Response `200`

Indicates request was successful and the form instances are returned

- DataResponseFormInstanceResponse
  - `data` FormInstanceResponse[]
    - `id` string
    - `formDefinitionId` string
    - `taskId` string
    - `processInstanceId` string
    - `processDefinitionId` string
    - `submittedDate` string, date-time
    - `submittedBy` string
    - `formValuesId` string
    - `tenantId` string
    - `url` string
    - `scopeId` string
    - `scopeType` string
    - `scopeDefinitionId` string
  - `total` integer
  - `start` integer
  - `sort` string
  - `order` string
  - `size` integer

## Other responses

- `400`: Indicates a parameter was passed in the wrong format . The status-message contains additional information.

---

[API](https://skmtc.dev/flowable/apis/flowable-form-rest-api.md) - [All operations](https://skmtc.dev/flowable/apis/flowable-form-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flowable/apis/flowable-form-rest-api/revisions/e581eab990c1?raw)