---
title: "Get a form instance"
method: GET
path: "/form/form-instance/{formInstanceId}"
tags: ["Form Instances"]
---

# Get a form instance

`GET /form/form-instance/{formInstanceId}`

## Request

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

## Path parameters

- `formInstanceId` string, required

## Response `200`

Indicates the form instance was found and returned.

- 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

## Other responses

- `404`: Indicates the requested form instance was not found.

---

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