---
title: "Get Digital Form"
method: GET
path: "/v1/form-instance/{form_instance_id}/"
tags: ["Form Instances"]
---

# Get Digital Form

`GET /v1/form-instance/{form_instance_id}/`

Get a Form Instance, including its contents

This endpoint is different from Get Raw Digital Forms in Bulk in a couple ways:

* It returns the contents of a single form instance.
* It returns the contents of the form instance when it was submitted, even if the form template has changed. If fields were added to the form template, they will not be included.
* Fields that refer to another object (Asset, Document, Site or User) are a link to the API endpoint for that object
* Attachments are a link to download that image.
* Tables are included.

## Path parameters

- `form_instance_id` integer, required

## Response `200`

Successful Response

- ApiGenericResponseFormInstanceDetailModel
  - `error` boolean — A boolean error indicator.
  - `message` string, nullable — Optional message.
  - `data` FormInstanceDetailModel
    - `id` integer, required
    - `formId` integer, required — Identifier of the form that this form instance was created from
    - `companyId` integer, required — The company identifier the form instance was submitted to
    - `fields` object, nullable, required — Contents of the submitted form instance

## Other responses

- `400` — Business Logic Error
- `403` — Permission Error
- `404` — Records Not Found
- `409` — Integrity Error or Data Conflict
- `422` — Validation Error

---

[API](https://skmtc.dev/salussafety/apis/salus-developer-api.md) · [All operations](https://skmtc.dev/salussafety/apis/salus-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/salussafety/salus-developer-api/revisions/ef065f44da25/schema)