---
title: "List all Forms"
method: GET
path: "/form.json"
tags: ["Forms"]
---

# List all Forms

`GET /form.json`

#### Filtering
This endpoint supports result filtering. For more information on how to filter this request, [go here](/docs/filtering).
			
			
#### OAuth Scope
This endpoint requires the following OAuth scope **read_forms**.

## Response `200`

An array of Forms

- Form[]
  - `name` string — The name of the form. Used to identify the form in the system and displayed to users in the form selector. Must be unique within an account. Maximum length is 255 characters.
  - `document_template_uuid` string, uuid — UUID of the document template associated with this form. The template defines the layout and appearance of the form when it's generated as a document. References a document template object in the system.
  - `can_be_used_independently` string — Boolean flag indicating whether this form can be used independently of a job. When set to true (1), the form can be filled out as a standalone form. When false (0), the form must be associated with a job to be completed.
  - `badge_mandatory_state` string — Controls when badge completion is mandatory for this form. Valid values are: 0 (not mandatory), 1 (mandatory on check-in), 2 (mandatory on check-out). This determines at which stage in the job lifecycle a staff member must complete this form.
  - `template_fields` object[] — JSON array of template fields that are used when generating form documents. Each field contains a name, fieldType, value, and sortOrder. Maximum of 10 fields allowed.
    - `name` string, required
    - `fieldType` 'Text', required
    - `value` string, required
    - `sortOrder` integer, required
  - `uuid` string, uuid — Unique identifier for this record
  - `active` 0 | 1 — Record active/deleted flag. Valid values are [0,1]. Valid values are [0,1]
  - `edit_date` string — Timestamp at which record was last modified
  - `badge_name` string

## Other responses

- `400` — Bad Request - The request is malformed or contains invalid parameters
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `403` — Forbidden - You don't have permission to access this resource
- `429` — Too Many Requests - You have exceeded the rate limit
- `500` — Internal Server Error - An unexpected error occurred on the server

---

[API](https://skmtc.net/servicem8/apis/servicem8-api.md) · [All operations](https://skmtc.net/servicem8/apis/servicem8-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/servicem8/servicem8-api/versions/53ede60e3653/schema)