---
title: "Query form instances"
method: POST
path: "/query/form-instances"
tags: ["Form Instances", "Query"]
---

# Query form instances

`POST /query/form-instances`

## Request

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

The request body can contain all possible filters that can be used in the List form instances URL query. On top of these, it’s possible to provide an array of variables to include in the query, with their format described here.

The general paging and sorting query-parameters can be used for this URL.

## Request body

- FormInstanceQueryRequest
  - `start` integer
  - `size` integer
  - `sort` string
  - `order` string
  - `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

## 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)